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Welcome to volume two of the Applesoft Reference Manual. This 
volume contains the appendices, the glossary, and the index to both 
volumes. The paging continues where volume one left off. 
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Appendix A 


Summary of Applesoft 
Statements and Functions 


Listed below are abbreviated descriptions of all Applesoft statements 
and functions. Each description is preceded by a syntactic definition 
and at least one example; see Appendix B for definitions of syntactic 
terms used here. References in square brackets at the end of each 
description give the section or appendix of this manual where more 
detailed information about the feature can be found. 


ABS 

Syntax: ABS (aexpr) 

Example: ABS (-2.77) 

Yields the absolute value (value without regard to sign) of the 
argument. The example yields 2.77. [2.4.1] 

ASC 

Syntax: ASC (sexpr) 

Example: ASC ("QUEST") 

Yields the ASCII code for the first character in the argument. The 
example yields 81 (ASCII code for Q). [4.2.5, C] 


Assignment Statement 

Syntax: C LET ] avar = aexpr 

CLET] svar = sexpr 
Example: LET A = 23.567 
A$ = "HUMBUG" 

Assigns the value of the expression following = to the variable 
preceding it. LET is optional. [2.2] 
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ATN 

Syntax: A T N (aexpr) 

Example: ATN (.8771) 

Yields the arc tangent, in radians, of the argument. The example 
yields .720001187 (radians). [2.4.1] 


CALL 

Syntax: CALL aexpr 
Example: CALL -822 

Executes a machine-language subroutine at the specified decimal 
memory address. The example issues a line feed. [7.1.3, F] 


CHR$ 

Syntax: CHR$ (aexpr) 

Example: CHR$ (85) 

Yields the character corresponding to the ASCII code given as an 
argument. The example yields the letter A. [4.2.5] 

CLEAR 

Syntax: CLEAR 
Example: CLEAR 

Resets ail variables and internal control information to their initial 
state. Program code is unaffected. [1.2.2] 


COLOR = 

Syntax: C 0 L 0 R = aexpr 

Example: C0L0R= 12 

Sets the display color for plotting low-resolution graphics. The 
example sets the display color to green. [6.1.2] 


CONT 

Syntax: CONT 
Example: CONT 

Resumes program execution after it has been halted by STO P, 
END, | control | -C, or (sometimes) | control | - [ reset ] . [1.3.3] 
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cos 

Syntax: COS (aexpr) 

Example: COS (2) 

Yields the cosine of the argument, which must be expressed in 
radians. The example yields - .416146836. [2.4.1] 


DATA 

Syntax: DATA [literal | string | real | integer] 

[ {t [literal | string | real | integer]} ] 

Example: DATA JOHN SMITH > "CODE 32" » 23.45, 

-6 

Creates a list of items for use by R E A D statements. In the example, 
the first item is the string "JOHN SMITH", the second is the 
string "CODE 32", the third is the real number 23.4 5, and the 
fourth is the integer - 6. [5.1.4] 

— 

DEF FN 

Syntax: DEF FN name (name) = aexpr 

Example: DEF FN CUBE (X) = X * X * X 

Defines a new function for use in the program. The example defines a 
function that yields the cube of its argument. [2.4.3] 

DEL 

Syntax: DEL linenum * linenum 
Example: DEL 23 > 56 

Deletes a range of consecutive lines from the program. The example 
deletes all lines numbered between 23 and 56, inclusive. [1.1.5] 

DIM 

Syntax: DIMname[%|$] subscript[{, name[7,j$] subscript}] 

Example: DIM MARK (50*3) » NAME$ (50) 

Defines and allocates space for one or more arrays. The example de¬ 
fines a two-dimensional real array MARK, whose first subscript var¬ 
ies from 0 to 5 0 and whose second varies from 0 to 3, and a string 
array N A M E $ with one subscript that varies from 0 to 5 0. [4.1.1 ] 
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DRAW 


Syntax: DRAW aexpr [ A T aexpr * aexpr] 


u 


Example: DRAW 4 AT 50*100 
DRAW 4 

Draws a shape at a specified point on the high-resolution graphics 
screen from the shape table currently in memory. The first example 
draws shape number 4, beginning in column 50, row 100, using the 
current color, scale, and rotation settings; the second example draws 
shape 4 at the last point plotted by H PLOT, DR AW, or XDR AW. 
[6.3.2] 

END 

Syntax: END 
Example: END 

Terminates the execution of the program and returns control to the 
user. No message is displayed. [3.6.2] 



EXP 


Syntax: EXP (aexpr) 

Example: EXP (2) 

Yields the mathematical exponential of its argument (the constant 
e = 2.7182818raised to the power specified bythe argument).The 
example yields e squared, or 7.38 30 5 B1. [2.4.1] 

FLASH 

Syntax: FLASH 

Example: FLASH 

Causes all text displayed on the screen with subsequent PRINT 
statements to flash between white-on-black and black-on-white. May 
not work properly for lowercase letters (and other characters with 
ASCII codes above 95) if the 80-Column Text Card is installed and 
running in “active-80” mode. [5.2.4] 
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FN 

Syntax: F N name (aexpr) 

Example: FN CUBE (B) 

Applies a designated function to the value of the argument expres¬ 
sion. Assuming the definition for the function CUBE given above 
under D E F F N, the example yields the value 21B. [2.4.3] 

FOR 

Syntax: FOR name = aexpr T 0 aexpr [STEP aexpr] 

Example: FOR J = 1 TO 10 

FOR MARK = 0 TO 100 STEP 5 
FOR NUMBER = 20 TO -20 STEP -2 

Marks the beginning of a loop, identifies the index variable, and gives 
the variable’s starting and ending values and (optionally) the amount 
by which it is to change (step) on each pass through the loop. The 
first example begins a loop whose index variable J will take on all val¬ 
ues from 1 to 10, stepping by 1; the second begins a loop whose in¬ 
dex variable MARK will take on values from 0 to 100, stepping by 5; 
the third begins a loop whose index variable N U M B E R will take on 
values from 20 to -20, stepping by -2. [3.3.1] 


FRE 

Syntax: FRE (expr) 

Example: FRE (0) 

Yields the amount of remaining memory, in bytes, available to the 
program. The argument is ignored, but must be a valid Applesoft 
expression. [7.2.3] 

GET 

Syntax: GET var 

Example: GET ANSWERS 

Accepts a single character from the keyboard without displaying it on 
the screen and without requiring that the | return | key be pressed. 
Program execution is suspended until the user presses a key. In 
the example, the character typed will be assigned to the variable 
ANSWERS.[5.1.3] 
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GOSUB 


Syntax: GOSUB linenum 
Example: GOSUB 250 

Executes a subroutine beginning at the designated line number 
(250 in the example). [3.4.1] 


GOTO 

Syntax: GOTO linenum 
Example: GOTO 400 

Sends control unconditionally to the designated line number (400 in 
the example). [3.1] 


GR 

Syntax: GR 
Example: GR 

Converts the display to 40 rows of low-resolution graphics with four 
lines of text at the bottom. The screen is cleared to black, the cursor 
is moved to the beginning of the last line, and the low-resolution 
display color is set to black. [6.1.1] 


HCOLOR = 

Syntax: H C □ L 0 R = aexpr 
Example: HC0L0R= 1 

Sets the display color for plotting high-resolution graphics. The 
example sets the display color to green. [6.2.3] 


HGR 

Syntax: HGR 
Example: HGR 


Converts the display to 160 rows of high-resolution graphics with four 
lines for text at the bottom. The screen is cleared to black and page 1 
of high-resolution graphics is displayed. The contents of the text dis¬ 
play, the location of the cursor, and the high-resolution display color 
are unaffected. [6.2.1] 
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HGR2 


Syntax: H G R 2 
Example: HGR2 

Converts the display to full-screen (192 rows) high-resolution graph¬ 
ics with no text. The screen is cleared to black and page 2 of high- 
resolution graphics is displayed. The contents of the text display, the 
location of the cursor, and the high-resolution display color are unaf¬ 
fected. [6.2.2] 


HI MEM 5 

Syntax: HI MEM : aexpr 

Example: HI MEM: 327G7 

Sets the address of the highest memory location available to the 
Applesoft program, including its variables. The example sets the end 
of program and variable storage to 3 2 7 G 7. Used to protect an area 
of memory for data, high-resolution graphics, or machine-language 
code. [7.2.1] 


HLIN 

Syntax: HLIN aexprl > aexpr2 AT aexpr3 
Example: HLIN 10 t 20 AT 30 

Draws a horizontal line in low-resolution graphics, using the current 
low-resolution display color. The example draws a line across row 
30 from column 10 to column 20. [6.1.4] 


HOME 

Syntax: HOME 
Example: HOME 

Clears all text from the text window and moves the cursor to the top- 
left corner of the window. [5.2.4] 
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HPLOT 

Syntax: HPLOT aexpr * aexpr [{TO aexpr » aexpr}] 

HPLOT TO aexpr* aexpr [{T0 aexpr > aexpr}] 
Example: HPLOT 75 * 20 

HPLOT 48* 115 TO 78* 84 TO 110* 115 
HPLOT TO 270* 10 

Plots a point or line on the high-resolution graphics screen in the cur¬ 
rent high-resolution display color. The first example plots a single 
point at column 75, row 20; The second example draws lines from 
column 48, row 115 to column 79, row 84 to column 110, row 115; the 
third draws a line to column 270, row 10 from the last point plotted 
with H P L 0 T, using the color of the last point plotted (not necessarily 
the current display color). [6.2.4] 

HTAB 

Syntax: HTAB aexpr 
Example: HTAB 23 

Positions the cursor to a specified column of the text display. The ex¬ 
ample moves the cursor to column 23. If you have the Apple lie 80- 
Column Text Card, see the manual accompanying that product for 
further information on using HTAB. [5.2.4] 

I F...THEN 

Syntax: IF expr THEN statement [ {: statement} ] 

IF expr THEN [GOTO] linenum 
IF expr [THEN] GOTO linenum 

Example: IF AGE < 18 THEN A = 0 s B = 1 : 

C = 2 

IF ANSWER$ = "YES" THEN GOTO 100 
IF N > MAX THEN GOTO 25 

IF N > MAX THEN 25 

IF N > MAX GOTO 25 

Executes or skips one or more statements, depending on the truth of 
a stated condition. The first example sets A to 0, B to 1, and C to 2 if 
the value of A G E is less than 18; the second branches to line 10 0 if 
the value of A N S W E R $ is the string "YES"; the last three all branch 
to line 2 5 if the value of N is greater than that of M A X. In all cases, if 
the stated condition is false, execution continues with the next pro¬ 
gram line. [3.2.2] 
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IN# 

Syntax: IN# aexpr 

Example: IN# 2 

Specifies the source for subsequent input. The example causes sub¬ 
sequent input to be read from the device in expansion slot 2. [5.1.1] 


INPUT 

Syntax: INPUT [sexpr 5 ] var [ {> var} ] 

Example: INPUT AX 

INPUT "TYPE AGE > THEN A COMMA # 

THEN NAME" 5 AGE * NAME$ 

Reads a line of input from the current input device. The first example 
reads a value into variable A %; the second displays a prompting mes¬ 
sage and then reads values into variables AGE and N A M E $. [5.1.2] 


INT 

Syntax: INT (aexpr) 

Example: INT (98.G) 

INT (-273.IB) 

Yields the integer part of the argument value. The examples yield 9 8 
and -274, respectively. [2.4.1 ] 


INVERSE 

Syntax: INVERSE 

Example: INVERSE 

Causes all text displayed on the screen with subsequent PRINT 
statements to appear in black-on-white instead of the usual white-on- 
black. May not work properly for lowercase letters (and other charac¬ 
ters with ASCII codes above 9 5) if the 80-Column Text Card is in¬ 
stalled and running in “active-80” mode. [5.2.4] 


LEFT$ 

Syntax: L E F T $ (sexpr > aexpr) 

Example: LEFT $ ( "APPLESOFT" t 5) 

Yields a specified number of characters from the beginning of a 
string. The example yields the string "APPLE". [4.2.4] 
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LEN 

Syntax: LEN (sexpr) 

Example: LEN ("NEVER A DULL MOMENT") 

Yields the length of a string in characters. The example yields 
[4.2.2] 

LET 

See “Assignment Statement,” above. 



19 . 


LIST 




Syntax: 

LIST 

[Iinenum1][~ 


LIST 

[linenumlji > 

Example: 

LIST 




LIST 

150 



LIST 

2 0 0 

-300 


LIST 

2 0 0 

> 30' 


Displays all or part of the program on the screen, or writes it to the 
current output device. The first example lists the entire program; the 
second lists line 150 only; the last two list all lines numbered from 
200 to 300, inclusive. [1.2.3] 


LOAD 


Syntax: LOAD [name] 
Example: LOAD 

LOAD DEMO 


Reads a program into memory from a disk or tape. The first example 
reads a program from a tape cassette; the second reads from a disk 
file named DEMO. If you have one or more disk drives, see your DOS 
manual for further information. [1.2.6, M] 


LOG 

Syntax: LOG (aexpr) 

Example: LOG (2) 

Yields the natural logarithm of the argument. The example yields 
♦ B93 147181. [2.4.1] 
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LOMEM; 

Syntax: LOMEM: aexpr 
Example: LOMEM: 2457G 

Sets the address of the lowest memory location available to the pro¬ 
gram for variable storage. The example sets the beginning of variable 
storage to 2 4 5 7 B. [7.2.2] 


M I D$ 

Syntax: MID $ (sexpr t aexpr [ > aexpr]) 

Example: MID$ CAN APPLE A DAY", 4, 5) 

MID$ ("AN APPLE A DAY"» 4) 

Yields a specified number of characters beginning at a specified po¬ 
sition in a given string. The first example yields the string "APPLE" 
the second yieldsthe string " APPLE A DAY".[4.2.4] 


NEW 

Syntax: NEW 

Example: NEW 

Clears the current program from memory and resets all variables and 
internal control information to their initial states. [1.2.1 ] 


NEXT 

Syntax: N E X T [ avar [ {> avar]} ] 

Example: NEXT 

NEXT INDEX 
NEXT J, I 

Marks the end of a loop and causes the loop to be repeated for the 
next value of the index variable, as specified in the corresponding 
FOR statement. The first example ends the most recently entered 
loop; the second ends the loop whose index variable is IN D E X; the 
third ends the pair of nested loops whose index variables are J and 
I. [3.3.2] 
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NORMAL 

Syntax: NORMAL 
Example: NORMAL 

Causes all text displayed on the screen with subsequent PRINT 
statements to appear in the usual white-on-black; cancels the effects 
of INVERSE or FLASH. [5.2.4] 

NOTRACE 

Syntax: NOTRACE 
Example: NOTRACE 


Stops the display of line numbers for each statement executed; 
cancels the effects of TRACE. [7.3.2] 


ON...GOSUB 


Syntax: 0 N aexpr G 0 S U B linenum [{ t linenum}] 

Example: ON ID GOSUB 100 » 200 » 23 t 4005 * 500 
Chooses a subroutine to execute depending on the value of an 
expression. The example transfers control to the subroutine begin¬ 
ning at line 100,200,23,4005 , or 500 , depending on whether 
the value of ID is 1,2,3,4, or 5; if ID has none of these values, 
execution continues with the next statement. [3.4.3] 


ON...GOTO 

Syntax: 0 N aexpr GOTO linenum [ {> linenum} ] 

Example: ON ID GOTO 100 » 200 » 23 # 4005# 500 


Chooses a line number to branch to depending on the value of an 
expression. The example transfers control to line 100,2 0 0,23, 

4 0 0 5, or 5 0 0, depending on whether the value of ID is 1,2, 3, 4, 
or 5; if ID has none of these values, execution continues with the 
next statement. [3.2.1] 

0NERR GOTO 

Syntax: ONERR GOTO linenum 
Example: ONERR GOTO 500 

Replaces Applesoft’s normal error-handling mechanism with a sub¬ 
routine beginning at a specified line number. The example estab¬ 
lishes an error-handling subroutine beginning at line 500. [3.5.1, E] 
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PDL 

Syntax: P D L (aexpr) 

Example: PDL ( 1 ) 

Reads the current dial setting on a designated hand control. The 
example reads the dial on hand control 1. [5.1.6, F.4] 


PEEK 

Syntax: PEEK (aexpr) 

Example: PEEK (37) 

Yields the contents of a specified location in memory. The example 
yields the contents of location 37, which contains the current vertical 
position of the text cursor on the display screen. [7.1.1, F.1 ] 


PLOT 

Syntax: PLOT aexpr > aexpr 

Example: PLOT 10 > 20 

Plots a single block of the current display color at a specified position 
on the low-resolution graphics screen. The example plots a block at 
column 10, row 20. [6.1.3] 


POKE 

Syntax: POKE aexpr > aexpr 

Example: POKE -16302* 0 

Stores a value into a specified location in memory. The example 
stores the value 0 at location 49234 (65536 - 16302), causing 
the display to switch from mixed graphics and text to full-screen 
graphics. [7.1.2, F] 


POP 

Syntax: POP 

Example: POP 

Removes the most recent return address from the control stack, 
causing the next RETURN statement to send control to the state¬ 
ment following the second most recently executed G 0 S U B. [3.4.4] 
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POS 

Syntax: POS (expr) 

Example: POS ( 0 ) 



y 


Yields the current horizontal position of the cursor on the text display. 
The argument is ignored, but must be a valid Applesoft expression. 
[5.2.4] 

PR# 

Syntax: PR#aexpr 

Example: PR# 1 


Specifies the destination for subsequent output. The example causes 
subsequent output to be sent to the device in expansion slot 1. [5.2.1 ] 

PRINT 

Syntax: PRINT [{expr[ #| 5]}] 

Example: PRINT 

PRINT A$> "X = ";X 

Writes a line of output to the current output device. The first example 
writes a blank line; the second writes the value of variable A$, fol¬ 
lowed at the next available tab position by the string " X = ", fol¬ 
lowed immediately by the value of variable X. [5.2.2] 


READ 

Syntax: RE AD var [ {> var} ] 

Example: READ A t BZ > C$ 

Reads values from DATA statements in the body of the program. 
The example reads values into variables A, BZ, and 0$. [5.1.4] 

RECALL 

Syntax: RECALL name[Z] 

Example: RECALL MX 

Reads values into an array from a tape cassette. The example reads 
values into array MX. [M] 
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REM 

Syntax: REM {character} 

Example: REM THIS A REMARK 

Includes remarks in the body of a program for the benefit of a human 
reader. [1.1.7] 

RESTORE 

Syntax: RESTORE 
Example: RESTORE 

Causes the next READ statement executed to begin reading at the 
first item of the first DAT A statement in the program. [5.1.5] 

RESUME 

Syntax: RESUME 

Example: RESUME 

At the end of an error-handling routine (see ONERR GOTO), 
causes resumption of the program at the beginning of the statement 
in which the error occurred. [3.5.2] 

RETURN 

Syntax: RETURN 
Example: RETURN 

Returns control from a subroutine to the statement following the 
G 0 S U B that called the subroutine. [3.4.2] 

RIGHTS 

Syntax: RIGHTS (sexpr > aexpr) 

Example: RIGHTS ("APPLESOFT" t 4) 

Yields a specified number of characters from the end of a string. The 
example yields the string "SOFT". [4.2.4] 

RND 

Syntax: RND (aexpr) 

Example: RND ( 1) 

Yields a random number between 0 and 1. Zero and negative argu¬ 
ment values yield repeatable sequences of random numbers. [2.4.2] 
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ROT = 

Syntax: R0T= aexpr 
Example: R □ T = 1G 

Sets the angular rotation for high-resolution shapes to be drawn with 
DRAWorK DRAM. The example causes the shape to be rotated 90 
degrees clockwise. [6.3.2] 


RUN 

Syntax: RUN [linenum | name] 
Example: RUN 

RUN 500 
RUN DEMO 


Executes an Applesoft program. The first example executes the pro¬ 
gram currently in memory from the beginning; the second executes 
the program in memory, starting at line 5 0 0; the third loads and exe¬ 
cutes a program from a disk file named D E M 0. [1.2.4] 


SAME 


Syntax: SAME [name] 

Example: SAME 

SAME DEMO 

Writes the Applesoft program currently in memory to a disk or tape. 
The first example writes the program to a tape cassette; the second 
writes it to a disk file named DEMO. [1.2.5, M] 

SCALE = 

Syntax: S C A L E = aexpr 

Example: S C A L E = 10 


Sets the scale factor for high-resolution shapes to be drawn with 
D R A W or X D R A W. The example causes the shape to be drawn ten 
times bigger than the definition given in the shape table. [6.3.2] 
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SCRN 


Syntax: SCRN (aexpr > aexpr) 

Example: SCRN (10# 20) 

Yields the code for the color currently displayed at a designated posi¬ 
tion on the low-resolution graphics screen. The example yields the 
code for the color at column 10, row 20. [6.1.6] 


SGN 

Syntax: SGN (aexpr) 

Example: SGN (-144) 

Yields a value of - 1,0, or + 1, depending on the sign of the argu¬ 
ment. The example yields - 1. [2.4.1 ] 


SHLOAD 

Syntax: SHLOAD 

Example: SHLOAD 

Loads a shape table into memory from a tape cassette. [6.3.2, M] 


SIN 

Syntax: SIN (aexpr) 

Example: SIN ( 2 ) 

Yields the sine of the argument, which must be expressed in radians. 
The example yields . 0 0 9 2 9 7 4 2 7. [2.4.1 ] 


SPC 

Syntax: SPC (aexpr) 

Example: SPC (8) 

Introduces a specified number of spaces into the line being written by 
a PR I NT statement. The example writes 8 spaces. [5.2.4] 


SPEED = 

Syntax: S P E E D = aexpr 

Example: SPEED= 50 

Sets sets the rate at which text characters are sent to the display 
screen or other input/output device. The slowest rate is 0; the fastest 
is 255. [5.2.4] 
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SQR 


Syntax: S 0 R (aexpr) 

Example: SOR (2) 

Yields the positive square root of the argument; the example yields 
1.4142135E. [2.4.1] 

STOP 

Syntax: STOP 
Example: STOP 

Terminates the execution of the program and returns control to the 
user. A message is displayed identifying the program line in which the 
STOP statement appears. [3.6.1 ] 

STORE 

Syntax: STORE name[X] 

Example: STORE MX 


Stores values from an array onto a tape cassette. The example 
stores the contents of array M X. [M] 


STR$ 


Syntax: S T R $ (aexpr) 
Example: STR$ (12.45) 


Yields a string representing the numeric value of the argument. The 
example yields the string "12.45". [4.2.5] 


TAB 


Syntax: TAB (aexpr) 

Example: TAB (23) 

Positions the text cursor to a specified position on the output line dur¬ 
ing execution of a P RIN T statement. The example moves the cursor 
to column 23. [5.2.4] 
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TAN 

Syntax: TAN (aexpr) 

Example: TAN (2) 

Yields the tangent of the argument, which must be expressed in radi¬ 
ans. The example yields - 2 ♦ 18 5 0 3 9 8 7. [2.4.1 ] 


TEXT 

Syntax: TEXT 

Example: TEXT 

Converts the display to 24 lines of text, with the cursor positioned at 
the beginning of the bottom line. [5.2.4] 


TRACE 

Syntax: TRACE 

Example: TRACE 

Causes the line number of each statement to be displayed on the 
screen as it is executed. [7.3.1] 


USR 

Syntax: USR (aexpr) 

Example: USR ( 3 ) 

Executes a machine-language subroutine supplied by the user, pass¬ 
ing it a specified argument. The subroutine is entered via a JM P 
(Jump) instruction stored at addresses $0 A through $0C hexadeci¬ 
mal. The example passes the argument value 3. [7.1.4] 


UAL 

Syntax: UAL (sexpr) 

Example: V AL ("-3.7E4") 

Yields the numeric value represented by the string supplied as an ar¬ 
gument. The example yields -370 0 0. [4.2.5] 
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ML IN 

Syntax: V LIN aexpr # aexpr A T aexpr 
Example: ML IN 10# 20 AT 30 

Draws a vertical line in low-resolution graphics, using the current low- 
resolution display color. The example draws a line down column 30 
from row 10 to row 20. [6.1.5] 


V T A B 

Syntax: V T A B aexpr 

Example: U T A B 15 

Positions the cursor to a specified row of the text display. The exam¬ 
ple moves the cursor to row 15. [5.2.4] 

WAIT 

Syntax: WAIT aexpr » aexpr [ » aexpr] 

Example: WAIT 43347# 15 

WAIT 43347# 15# 12 

Suspends program execution until a specified bit pattern appears at 
a specified memory location. Used to wait for a status signal from a 
peripheral device. The second and (optional) third arguments are 
masks: the second specifies which bits of the designated location are 
of interest, the third specifies the values to be tested for in those bits. 
The first example suspends execution until a one bit appears in any 
of the four low-order bit positions of location 4 3 3 4 7; the second 
waits for a one bit in position 0 or 1 or a zero bit in position 2 or 3. 
[7.1.5] 

XDRAW 

Syntax: XDRAW aexpr [A T aexpr # aexpr] 

Example: XDRAW 4 AT 50# 100 
XDRAW 4 

Draws a shape from the shape table currently in memory at a speci¬ 
fied point on the high-resolution graphics screen. Each point in the 
shape is plotted using the complement of the color currently dis¬ 
played at that point. Typically used to erase a shape already drawn. 
The first example erases shape number 4, beginning in column 50, 
row 100, using the current scale and rotation settings; the second ex¬ 
ample erases shape 4 at the last point plotted byHPLOT,DRAW,or 
XDRAW. [6.3.2] 
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Appendix B 


Syntax Definitions 


Terms used in the syntax definitions in Appendix A are defined below. 
The following symbols are used in the syntax definitions: 

:= means “is defined as” 

| separates alternative definitions 

(alternative definitions for the same term may also be given 
separately) 

[ ] enclose elements that may be omitted 
{} enclose elements that may be repeated one or more times 

aexpr (arithmetic expression) 

: = real | integer | avar | fcall 
: = unop aexpr 
: = aexpr alop aexpr 
: = sexpr relop sexpr 
: = (aexpr) 

Parentheses may not be nested more than 36 levels deep. 

alop (arithmetic or logical operator) 

: = aop | relop | lop 

aop (arithmetic operator) 

:= + | - | * | / | '• 

avar (arithmetic variable) 

: = realvar | intvar 

character 

: = letter | digit | spchar | quote | space 

digit 

:=0|1|2|3|4|5|G|7|B|9 
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expr (expression) 

:= aexpr | sexpr 

fcall (function call) 

: = name ( expr [ {* expr} ] ) 

integer 

:= [+ | - ]{digit} 

Valid integers must be between -32767 and +32767. 

intvar (integer variable) 

: = name! [subscript] 

letter 

: = uppercase | lowercase 
line 

: = linenum [ {statement:} ] statement | return | 

linenum (line number) 

:= digit [ {digit} ] 

Line numbers must be in the range 0 to 63999. 

literal 

: = [ {character} ] 

lop (logical operator) 

:= AND | OR 

Notice that N 0 T is not included here, 
lowercase 


a 

b | 

c 

d | 

e | 

f i 

3 

h | 

i 

J 

1 K | 

1 

m 

1 n 

1 0 

| p 


r 1 

I s 

t 

u 

1 U 1 

w 

X 

y 

z 









name 

: = uppercase [ {uppercase | digit} ] 

A name may be of any length. When distinguishing one 
name from another, Applesoft ignores any characters after 
the first two. However, even the ignored portion of a name 
must not contain a special character or any of Applesoft’s 
reserved words. 
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quote 

. _ !! 


:= [ + 
:= [ + 


- ] {digit} [ . {digit} ] [ E [ + - ] [ digit [digit] ] ] 

- ] [ {digit} ] ♦ [ {digit} ] [ E [+ - ] [ digit [digit] ] ] 


The letter E in a real number stands for “times ten to the 
power.” Valid reals must be between - 1E 3 8 and 
+ 1E38. 

Applesoft recognizes the following as reals and evaluates 
them as zero: 

♦ +« -♦ . E + ♦ E - ♦ E 

,E+ .E- + .E + + ♦ E - - ♦ E + - * E- 


In addition, the following are recognized as reals and 
evaluated as zero when used as numeric responses to 
INPUT or as numeric elements of D A T A: 


| SPACE | 

+ 

E 

+ E 

-E 

E + 

E- +E + 

+ E- 

-E + 

-E- 


The GET statement evaluates all of the single-character 
reals listed above as zero. 

realvar (real variable) 

: = name [subscript] 

relop (relational operator) 


schar (string character) 

: = letter | digit | spchar | space 

Notice that the quote character (") is not included here. 

sexpr (string expression) 

: = string | svar | sfcall 
: = sexpr sop sexpr 
: = (sexpr) 

Parentheses may not be nested more than 36 levels deep. 
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sfcall (string function call) 

:= name$ ( expr [ {> expr} ] ) 

sop (string operator) 

:= + 


space 

:= | space 1 


spchar (special character) 


+ 

- 

* 

/ i 

.*• 

= 



( i 

) | 

t 

* 

: 

5 

1 

$ 1 

# 

1 ? 

1 8. 

/ | 

e 


| L 

| 3 

| { 

| > 

| \ 

! 


1 ' | 


Control characters (characters typed while holding down 
the | control 1 key) and the null characer are also 
considered special characters. Notice that the quote 
character (") and | space | are not included here. 

statement 

See Appendix A for syntactic definitions of all Applesoft 
statements. 


string 

:= "[{schar}]" 

:= "[{schar}] 

The second form of string can appear only at the end of a 
line. 


subscript 

: = ( aexpr [ {t aexpr} ] ) 

The maximum number of dimensions (aexpr’s) is 89, 
although in practice this is limited by the extent of memory 
available. 


svar (string variable) 

:= name $ [subscript] 

unop (unary operator) 

:= +1-1 NOT 
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uppercase 


A | 

B | 

C | D | 

E 

1 F 1 

G 

1 H 1 

I | J | K | 

L 

1 M 

| N | 0 j 

P 

1 o 1 

R 

1 s 1 

t | u | u | 

1*1 

1 x 1 

Y | Z 







var (variable) 

:= avarIsvar 
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L 

y 

u 

u 

y 

y 

y 

y 

u 

u 

y 

y 

u 

u 

u 

y 

L 

y 

y 

L 

y 

y 

y 

u 
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Appendix C 


ASCII Character Codes 


Below is a chart of the ASCII (American Standard Code for Informa¬ 
tion Interchange) character codes. The first 32 codes represent con¬ 
trol characters; to type these characters from the Apple lie keyboard, 
press the [control] key and hold it down while pressing the desig¬ 
nated character. (Some of these characters also have single-key 
representations, as noted.) The abbreviations given for these codes 
in the column labeled “Char” represent standard control functions 
originally intended for use on teletypes; the meanings of these ab¬ 
breviations are given in the “Meaning” column. Functions marked 
with an asterisk (*) are implemented on the Apple lie; the others are 
listed purely for historical interest. 

Dec = decimal ASCI I code 

Hex = hexadecimal ASCII code 

Char = ASCII character name 

Type = Apple lie keyboard representation 


Dec 

Hex 

Char 

Type 




Meaning 

0 

00 

NUL 

| CONTROL 

|-@ 



* null character 

1 

01 

SOH 

| CONTROL 

|-A 



start of heading 

rp 

02 

STX 

| CONTROL 

|-B 



start of text 

3 

03 

ETX 

| CONTROL 

I-C 



end of text 

a 

04 

EOT 

| CONTROL 

|-D 



end of transmission 

5 

05 

ENQ 

| CONTROL 

|-E 



enquiry 

G 

OB 

ACK 

| CONTROL 

)-F 



acknowledge 

7 

07 

BEL 

| CONTROL 

|-G 



* bell 

8 

08 

BS 

| CONTROL 

|-H 

or 

|left-arrow| 

* backspace 

9 

09 

HT 

| CONTROL 

l-I 



horizontal tab 

10 

OA 

LF 

| CONTROL 

|-J 

or 

|down-arrow| 

* line feed 

11 

OB 

OT 

[ CONTROL 

j-K 

or 

| up-arrow”! 

vertical tab 

12 

OC 

FF 

| CONTROL 

l-L 



form feed 
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Dec 

Hex 

Char 

Type 



Meaning 


13 

OD 

CR 

| CONTROL |-M 


RETURN 

* carriage return 


i a 

OE 

SO 

| CONTROL |-N 



shift out 


15 

OF 

SI 

| CONTROL |-0 



shift in 


IB 

10 

DLE 

| control|-P 



data link escape 


17 

1 1 

DC 1 

j CONTROL |-Q 



device control 1 


18 

12 

DC2 

| control|-R 



device control 2 


19 

13 

DC3 

| CONTROL |-S 



device control 3 


20 

14 

DC4 

| CONTROL |-T 



device control 4 


21 

15 

NAK 

| CONTROL |-U 

0r 

RIGHT-ARROW 

| negative acknowledges 

rp rp 

18 

SYN 

| CONTROL j-U 



synchronous idle 


23 

17 

ETB 

| CONTROL |-W 



end of transmission 








block 


24 

18 

CAN 

| CONTROL|-X 



* cancel 


25 

19 

EM 

| CONTROL |-Y 



end of medium 


2G 

1A 

SUB 

| CONTROL j-Z 



substitute 


27 

IB 

ESC 

| CONTROL |-C 

or | 

ESC | 

escape 


28 

1C 

FS 

I control|-\ 



file separator 


29 

ID 

GS 

I control|-] 



group separator 


30 

IE 

RS 

| CONTROL I-' - ' 



record separator 


31 

IF 

US 

| CONTROL |-_ 



unit separator 



The following characters can be typed directly from the keyboard: 


Dec 

Hex 

Char 

32 

20 

| SPACE | 

33 

21 

1 

34 

*p 'p 

n 

35 

23 

# 

38 

24 

$ 

37 

25 

1 

38 

28 

& 

39 

27 

/ 

40 

28 

( 

41 

29 

) 

42 

2 A 

* 

43 

2B 

+ 

44 

2C 

t 

45 

2D 

— 

48 

2E 

* 

47 

2F 

/ 

48 

30 

0 

49 

31 

1 

50 

32 

*p 
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Char 


Dec Hex 

51 33 3 

52 34 4 

53 35 5 

54 3G G 

55 37 7 

5G 38 8 

57 38 3 

58 3 A : 

53 3B 5 

GO 3C < 

G1 3D = 

G2 3E > 

63 3F ? 

64 40 § 

65 41 A 

66 42 B 

67 43 C 

68 44 D 

63 45 E 

70 46 F 

71 47 G 

72 48 H 

73 43 I 

74 4A J 

75 4B K 

76 4C L 

77 4D M 

78 4E N 

73 4F 0 

80 50 P 

81 51 Q 

82 52 R 

83 53 S 

84 54 T 

85 55 U 

86 56 0 

87 57 W 

88 58 X 

83 53 Y 

30 5A Z 

31 5B [ 

32 56 \ 

33 5D ] 

34 5E - 
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Dec 

Hex 

Char 

95 

5F 


96 

60 

' 

97 

61 

a 

98 

62 

b 

99 

63 

c 

100 

64 

d 

101 

65 

e 

102 

66 

f 

103 

67 

a 

104 

68 

h 

105 

69 

i 

106 

6 A 

J 

107 

6B 

k 

106 

6C 

l 

109 

6D 

m 

110 

6E 

n 

1 1 1 

6F 

0 

112 

70 

p 

113 

71 

q 

114 

72 

r 

115 

73 

5 

116 

74 

t 

117 

75 

u 

118 

76 

u 

119 

77 

w 

120 

78 

X 

121 

79 

Y 

1 22 

7A 

z 

123 

7B 

■c 

124 

70 

! 

125 

7D 

> 

126 

7E 

tv 

127 

7F 

j DELETE 1 
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Appendix D 


Reserved Words 


Following is a list of Applesoft’s reserved words. In most cases, these 
character sequences cannot be used as, or embedded in, variable 
names (but see the comments at the end of the list). 


ABS 

AND 

ASC 

AT 

ATN 



CALL 

CHR$ 

CLEAR 

COLOR = 

CONT 

COS 


DATA 

DEF 

DEL 

DIM 

DRAW 



END 

EXP 






FLASH 

FN 

FOR 

FRE 




GET 

GOSUB 

GOTO 

GR 




HCOLOR = 

HGR 

HTAB 

HGR2 

HIMEM: 

HLIN 

HOME 

HPLOT 

IF 

IN# 

INPUT 

INT 

INVERSE 



LEFT$ 

LEN 

LET 

LIST 

LOAD 

LOG 

LOMEM: 

MI D$ 







NEW 

NEXT 

NORMAL 

NOT 

NOTRACE 



□ N 

ONERR 

OR 





PDL 

PEEK 

PRINT 

PLOT 

POKE 

POP 

POS 

PR# 

READ 

RECALL 

REM 

RESTORE 

RESUME 

RETURN 

R I GHT$ 


RND 

ROT = 

RUN 




SAVE 

SCALE = 

SCRN 

SGN 

SHLOAD 

SIN 

SPC 


SPEED = 

SQR 

STEP 

STOP 

STORE 

STR$ 

TAB 

TAN 

TEXT 

THEN 

TO 

TRACE 


USR 







UAL 

ML IN 

VTAB 





WAIT 







XDRAW 

XPLOT 
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Applesoft tokenizes these reserved words (converts them into one- 
byte internal codes); see Section H.4 for a list of tokens. All other 
characters in a program occupy one byte each of program storage. 

The ampersand character (&) is reserved for Applesoft’s internal use 
and for user-supplied machine-language routines. When executed as 
an instruction, it causes a J S R to address $0 3 F 5 hexadecimal. 

X P L 0 T is a reserved word that does not correspond to a current 
Applesoft statement. 

Some reserved words are recognized by Applesoft only in certain 
contexts: 

• COLOR, HCOLOR, ROT, SCALE, and SPEED are interpreted 
as reserved words only if the next nonspace character is an 
equal sign (=). This is of little benefit in the case of C 0 L 0 R and 
H C 0 L 0 R, as the embedded reserved word 0 R prevents their 
use as variable names anyway. 

• HIMEM and LOMEM are interpreted as reserved words only if 
the next nonspace character is a colon (:). 

• IN and P R are interpreted as reserved words only if the next 
nonspace character is a number sign (#). 

• SCRN.SPC, and T A B are interpreted as reserved words only if 
the next nonspace character is a left parenthesis, (. 

• A T N is interpreted as a reserved word only if there is no space 
between the T and the N. If a space occurs between the T and 
the N, the reserved word AT is interpreted instead of ATN. 

• T 0 is interpreted as a reserved word unless preceded by an A 
and there is a space between the T and the 0. In that case, the 
reserved word A T is interpreted instead of T 0. 

Even if you don’t embed reserved words in your variable names, they 
can sometimes pop up unexpectedly and cause problems. For exam¬ 
ple, the statement 

100 FOR A - LOFT OR LEFT TO 15 
is interpreted as 

100 FOR A = LOF TO RLEFT TO 15 

and causes a syntax error. To force the correct interpretation, use 
parentheses: 

100 FOR A = (LOFT) OR (LEFT) TO 15 
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Appendix E 


Error Messages 


Below is a list of Applesoft’s error messages and their causes. When 
an error occurs in immediate execution, Applesoft sounds a “beep” 
and displays a message of the form 

?XX ERROR 

where X X is the name of the particular error, as listed below. 

In deferred execution (during the course of a running program), the 
message takes the form 

?XX ERROR IN YY 

where Y Y is the line number of the statement in which the error oc¬ 
curred; the Applesoft prompt character (]) and the cursor are dis¬ 
played, and control of the system is returned to the user. Variable 
values and the text of the program remain intact, but internal control 
information is erased and the program cannot be continued with the 
CONT command (see Section 1.3.3). An error in a deferred-execu¬ 
tion statement is not detected until the statement is executed. 

The error handling described above can be overridden by an error¬ 
handling routine in the program itself, established with the □ N E R R 
GOTO statement (see Section 3.5.1). Error codes for use in such an 
error-handling routine are given below in square brackets following 
the error names. When an error occurs, the code listed is stored at 
location 222 decimal; it can be retrieved from that location with the 
PEEK function (see Section 7.1.1). Errors for which no code is given 
cannot occur in deferred execution. 

Errors associated with the Disk Operating System (DOS) will also 
register at location 222; see the DOS manual for further information. 
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Debugging suggestions given below under the individual error mes¬ 
sages are not intended to be exhaustive or comprehensive; the 
causes of program bugs are numberless as the sands of the sea and 
the stars of the sky. 


BAD SUBSCRIPT [107] 

A reference was made to an array element that is outside the dimen¬ 
sions of the array. This error can occur if the wrong number of dimen¬ 
sions is used in an array reference: for instance, 

LET A<1 > 1 » 1 ) = Z 

when A has been defined by 

DIM A(2 >2) 


CAN'T CONTINUE 

An attempt was made to continue a program with the C 0 N T com¬ 
mand when no program exists in memory, or after an error, or after a 
line has been changed, deleted from, or added to the program. 


DIVISION BY ZERO [133] 

An attempt was made to divide by zero; division by zero is mathemat¬ 
ically undefined. Often occurs when a variable is used in an arithme¬ 
tic expression before begin given a value (all numeric variables 
initially have the value zero). To debug, examine the divisor of the 
expression where the error occurred to see why it unexpectedly has 
a zero value. Look particularly for variables that have inadvertently 
been used without having been given a nonzero value. 


FORMULA TOO COMPLEX [101] 

More than two statements of the form 

IF "ZZ" THEN 

were executed (where " Z Z" is any quoted string). The Applesoft 
I F...THEN statement wasn’t intended to be used with strings, and 
the results of such statements are not meaningful. The wisest policy 
is to avoid this type of construction altogether. 
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ILLEGAL DIRECT 

An attempt was made to use one of the following statements in imme¬ 
diate execution: 

• DEF FN 

• GET 

• INPUT' 

• ONERR GOTO 

• READ 

• RESUME 

ILLEGAL QUANTITY [53] 

The argument supplied to a statement or function was out of the al¬ 
lowed range. This error can be caused by 

• a negative array subscript (for example, LET A (-1) = 0) 

• LOG with a negative or zero argument 

• SOR with a negative argument 

• A '' B with A negative and B not an integer 

• useofLEFT$,MID$,RIGHT$, WAIT, PEEK, POKE, 
CALL, TAB, SPC, ON...GOTO, 0N...G0SUB, orany of the 
graphics statements or functions with an improper argument 


NEXT WITHOUT FOR [0] 

The variable named in a N E X T statement did not agree with the vari¬ 
able in the corresponding FOR statement, or a nameless NEXT was 
executed when no F 0 R was in effect. The most common causes of 
this error are forgetting a F 0 R or N E X T statement, typing the wrong 
variable in the NEXT statement, crossing loops, or accidentally 
branching into the body of a F 0 R loop. 
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OUT OF DATA [42] 

A R E A D statement was executed after all D A T A statements in the 
program had already been read. A R E A D statement may have been 
executed more times than intended (for example, in an infinite loop), 
or one or more DATA statements may have been inadvertently omit¬ 
ted. Sometimes caused by accidentally leaving outaRESTORE 
statement. 

OUT OF MEMORY [77] 

Any of the following can cause this error: 

• Program too large 

• Too many variables 

• FOR loops nested more than 10 levels deep _ 

• Subroutine calls nested more than 24 levels deep 

• Parentheses nested more than 36 levels deep 

• Too complicated an expression 

• Attempt to set L 0 M E M : too high M 

• Attempt to set L 0 M E M : lower than present value 

• Attempt to set HI M E M : too low 

OVERFLOW [69] 

The result of an arithmetic calculation was too large to be repre¬ 
sented in Applesoft’s internal number format. 

REDIM'D ARRAY [120] 

An attempt was made to define the same array twice in the same or 
different DIM statements. This error often occurs if an array has 
been referred to in a statement such as 

LET A (I) = 3 

before being defined in a DIM statement. At first reference, the array 
is automatically defined with an assumed dimension of 10; if such a 
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statement is followed later in the program by 
DIM A (100) 

the RED I M 'D ARRAY error will result. Another common cause of 
the error is a program that loops back to a line before the DIM state¬ 
ment, consequently executing it a second time. 

This error message can prove useful if you wish to discover on what 
program line an array was defined: just insert a DIM statement for the 
array in the first line, run the program, and the program will halt with a 
REDIM'D ARRAY error when the original DIM statement is 
executed. 


RETURN WITHOUT GOSUB [22] 

A R E T U R N statement was encountered without a corresponding 
GOSUB having been executed. This error often occurs when control 
accidentally branches into a subroutine via a GOTO statement, or 
“falls into” a subroutine because there is no END or GOTO state¬ 
ment at the end of the program segment preceding the subroutine. 


STRING TOO LONG [17B] 

An attempt was made by use of the concatenation operator (+) to 
create a string more than 255 characters long. This error tends to oc¬ 
cur when a string variable is used more than once without being 
cleared (that is, without being reset to the null string). 


SYNTAX ERROR [IS] 

A statement or expression doesn’t conform to Applesoft’s syntax 
rules. There are a myriad of possible causes for this error, such as a 
missing parenthesis, illegal character, or incorrect punctuation. Often 
results from a simple typing error. 


TYPE MISMATCH [163] 

The left side of an assignment statement was a numeric variable and 
the right side was a string, or vice versa; or a function that expected a 
string argument was given a numeric one or vice versa. Often caused 
by inadvertently leaving out the dollar sign ($) in a string variable or 
function name. 
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UNDEF'D FUNCTION [224] 

A reference was made to a function that had never been defined. May 
occur when you type something like F N L ( X ) when you meant to 
type F N I ( X ); that is, a simple case of mistaken identifier. 


UNDEF ' D STATEMENT [SO] 

l 

An attempt was made to transfer control, via G 0 T D, G 0 S U B, or 
IF...THEN, to a nonexistent line number. Common causes include 
accidentally deleting a line, changing a line number without changing 
references from other lines accordingly, and simple typing errors. 
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Appendix F 


Peeks, Pokes, and Calls 


PEEK function : see Section 7.1.1 
POKE statement : see Section 71.2 
CALL statement : see Section 71.3 


This appendix discusses some of the many special features of the 
Apple lie that you can use in your Applesoft programs by means of 
PEEK, POKE, or CALL statements. Notice that some of them dupli¬ 
cate the effects of other Applesoft features. 


soft switch: a location in memory that 
produces some special effect whenever 
its contents are read or written 


Many of these special addresses are soft switches with the property 
that any reference to them, whether a read (that is, a P E E K) or a 
write (a P 0 K E), invokes the feature associated with the address. For 
instance, the example given here for switching from text to graphics 
without clearing the graphics screen is 


POKE - 16304 t 0 


but you can get the same effect by executing 
X = PEEK (-16304) 


or by using P 0 K E to address - 1G 3 0 4 with a value other than 0. 
This does not apply in cases where you must use P 0 K E to store a 
specific value into the special address, such as a margin setting or a 
cursor location. 


For more information on special features accessible with PEEK, 
POKE, and CALL, see the Apple lie Reference Manual. 


Screen Text 

The special locations described in this section are used for control¬ 
ling the display of text on the screen: setting the boundaries of the 
text window within which characters are displayed and scrolled, 
clearing all text from all or part of the screen, scrolling text within the 
text window, and controlling the position of the cursor. 
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Setting the text window does not clear the remainder of the screen (for 
HOME,HTAB,M TAB statements : see which you can use HOME) and does not move the cursor into the new 
Section 5.2.4 text window (use HOME again, or HT AB and VT AO). 


POKE 32 t L 

Setting the text window Sets the left edge of the text window to the value specified by expres¬ 

sion L. This value should be between 0 and 39 (or 0 and 79 if 
you’re using the 80-Column Text Card), where 0 represents the 
leftmost column of the screen. 

The change doesn’t become visible until the cursor attempts to return to 
the left edge of the window. 


Warning 


The width of the window is not changed by this statement: this means 
that the right edge will be moved by the same amount you move the left 
edge. To protect your program and Applesoft, first reduce the window 
width appropriately (see below); then change the left edge. 


POKE 33 # M 

Sets the width of the text window (number of characters per line) to 
the value specified by expression W. This value should be between 1 
and 40 (or 1 and 80 if you’re using the 80-Column Text Card). 


Warning 

Make sure the right edge of the text window doesn’t extend past the right 
edge of the display screen. The window width shouldn’t be set greater 
than 40 (or 80) minus the current left edge of the window. For example, 
if you’ve set the left edge of the window (see above) to 10, don’t set the 
window width greater than 3 0 (or 7 0 with the 80-Column Text Card). 
Setting the window too wide will cause display text to be written outside 
the usual memory area reserved for it, destroying parts of your program 
or vital system information. 


Warning 

Do not set the window width to zero! The statement 
POKE 33 , 0 


will cause the system to crash. 


TAB function: see Section 5.2.4 If W is less than 33, the T A B function in a PR I NT statement may 

cause characters to be displayed outside the text window. 
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POKE 34 t T 

Sets the top edge of the text window to the value specified by expres¬ 
sion T. This value should be between 0 and 23, where 0 represents 
the top line of the screen. 

Warning 

Do not set the top edge of the window (T) lower than the bottom edge 
(see below). 


POKE 35t B 

Sets the bottom edge of the text window to the value specified by 
expression B. This value should be between 0 and 23, where 23 
represents the bottom line of the screen. 


Warning 


Make sure the bottom of the text window doesn’t extend past the bottom 
of the display screen. Setting the window bottom beyond line 23 will 
cause display text to be written outside the usual memory area reserved 
for it, destroying parts of your program or vital system information. 


Warning 

Do not set the bottom edge of the window (B) higher than the top edge 
(see above). 


CALL -93B 

Clearing text from the screen Clears all text within the text window and moves the cursor to the top- 

left corner of the window. The effect is the same as that of the H 0 M E 
statement or of typing | esc | @ from the keyboard. 


CALL -358 

Clears all characters inside the text window from the current cursor 
position to the bottom-right corner. Characters above and to the left 
of the cursor are not affected. The effect is the same as that of typing 
| esc | F from the keyboard. 


CALL -8S8 

Clears all characters inside the text window from the current cursor 
position to the end of the line. The effect is the same as that of typing 
| esc | E from the keyboard. 
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Scrolling text on the screen 


Positioning the cursor 


CALL -922 

Issues a line feed character, causing the cursor to move down 
one line without changing its horizontal position. If the cursor is on 
the bottom line of the text window, the contents of the window 
are scrolled up one line. The effect is the same as that of typing 
I control 1 -J from the keyboard. 


CALL -912 


Scrolls all text within the text window up one line. The old top line 
is lost; the old second line becomes the top line; the bottom line 
becomes blank. Text outside the text window is not affected. 


PEEK (36) 

Yields the current horizontal position of the cursor, which will be a 
number between 0 and 39 (0 and 79, if you’re using the 80-Column 
Text Card). The cursor position is given relative to the left edge of the 
text window, not the left edge of the screen. The effect is the same as 
that of the POS function (see Section 5.2.4). 


POKE 36 t CH 

Moves the cursor to the horizontal position specified by expression 
CH, which is interpreted relative to the left edge of the text window, 
not the left edge of the screen. The value of this expression should be 
between 0 and the current width of the window, with 0 representing 
the leftmost column of the window. The effect is the same as that of 
the HT AB statement (see Section 5.2.4), but is not limited to 40 
columns. 

Like H T A B, this statement can move the cursor beyond the right edge 
of the text window, but only long enough to display one character. 


80-Column Text Card Users: You can use this POKE statement to 
position the cursor in columns 40 to 79 of the screen, which are 
inaccessible with HT AB. 
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Warning 

Don’t move the cursor past the right edge of the display screen! The cur¬ 
sor position shouldn’t be set greater than 4 0 (or 8 0) minus the current 
left edge of the window. For example, if you’ve set the left edge of the 
window (see above) to 10, don’t set the cursor position greater than 3 0 
(or 7 0 with the 80-Column Text Card). Moving the cursor too far to the 
right may cause display text to be written outside the usual memory area 
reserved for it, destroying parts of your program or vital system 
information. 


PEEK (37) 

Yields the current vertical position of the cursor, which will be a num¬ 
ber between 0 and 23. The cursor position is given relative to the top 
edge of the screen, not the top edge of the text window. A value of 0 
represents the top line of the screen, 2 3 the bottom line. 


POKE 37t CM 

Moves the cursor to the vertical position specified by expression C V, 
which is interpreted relative to the top of the screen, not the top of the 
text window. The value of this expression should be between 0 and 
23, with 0 representing the topmost line of the screen. The effect is 
similar to that of the M T A B statement (see Section 5.2.4), except that 

• screen lines are numbered from 0 to 23, not from 1 to 24 as 
with UTAB 

• the specified cursor position is not limited to 2 4 lines 

Like M T A B, this statement can move the cursor beyond the bottom 
edge of the text window, but all subsequent text sent to the display 
screen will then appear on that same line. 


Warning 

Don’t move the cursor past the bottom edge of the display screen! Set¬ 
ting the cursor position beyond line 2 3 will cause display text to be writ¬ 
ten outside the usual memory area reserved for it, destroying parts of 
your program or vital system information. 
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Reading the keyboard 


Keyboard 

The special locations described below are used for reading input 
directly from the keyboard. 


PEEK (-16384) 

Reads the last character typed from the keyboard. If the high-order 
bit of this location is 1 (PEEK yields a result > 12 7), then a new 
character has been typed since the last P 0 K E to address - 1B 3 G 8 
(see below); subtracting 128 from the value received gives the 
ASCII code for the character typed. If the high-order bit is 0 (PEEK 
yields a result > = 127), then no new character has been typed 
since the last POKE to - 18388. 


POKE - 16368 t 0 

Clears the high-order bit of location - 18 3 8 4 (see above) to prepare 

for reading another keyboard character. This should be done imme¬ 
diately after reading the keyboard viaPEEK(-18384). 

Graphics 

Four areas are reserved in the Apple lie’s memory for displaying text 

and graphics on the screen: 

• Low-resolution page 1 is located at addresses $ 4 0 0 to $ 7 F F 
hexadecimal (1024 to 2047 decimal). Information stored in 
this area can be interpreted and displayed on the screen in the 
form of either text or low-resolution graphics. This is the usual 
area of memory used for both these purposes, and is the area 
used by Applesoft’s TEXT and GR statements. 

• Low-resolution page 2, at addresses $ 8 0 0 to $ B F F hexadeci¬ 
mal (20 4 8 to 30 71 decimal), can be used as an alternate area 
for either text or low-resolution graphics. Since this is the same 
area as the beginning of Applesoft’s normal program storage 
space (see Section H.1, “Apple lie Memory Map”), using it for 
text or graphics is tricky and is not recommended. 

• High-resolution page 1, at addresses $ 2 0 0 0 to $ 3 FF F hexa¬ 
decimal (8182 to 18383 decimal), is the usual area for high- 
resolution graphics, and is accessible via Applesoft’s H G R 
statement. 

• High-resolution page 2, at addresses % 4 0 0 0 to $ 5 F F F hexa¬ 
decimal (18384 to 24575 decimal), serves as an alternate 
area for high-resolution graphics, and is accessible via Apple¬ 
soft’s HGR2 statement. 
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soft switch: a location in memory that 
produces some special effect whenever 
its contents are read or written 


For more information... 


Displaying graphics 


To use the different text and graphics areas, you can use Applesoft’s 
built-in text and graphics facilities or you can use PEEK and POKE 
to manipulate the soft switches that control the display of text and 
graphics. There are four such soft switches, each consisting of a pair 
of special locations in the Apple lie’s memory. Any PEEK or POKE to 
one of the locations in the pair sets the switch one way; a P E E K or 
P 0 K E to the other location in the pair sets the switch the other way. 

The addresses shown in parentheses in the list below are those of 
the special locations that control the various settings of the switches. 
Each address is given first in hexadecimal (preceded by a dollar sign, 
$) and then ip the equivalent decimal form. 

The four soft switches controlling the display choose between 

• text ($0051, - 1B303) and graphics ($0050, -16304) 

• high ($0057, - 16297) and low resolution ($0056, 
-16298) 

• page 1 ($0054, - 16300) and page 2 ($0055, 

-16299) 

• full-screen graphics ($0052, - 16302) and mixed text and 
graphics($0053, -16301) 

For further information on these and other soft switches in the Apple lie’s 
memory, see the Apple lie Reference Manual. 


POKE - 16304 t 0 

Switches the display from full-screen text to graphics without clearing 
the graphics screen. Depending on the settings of the other soft 
switches, the resulting display may be high- or low-resolution graph¬ 
ics, taken from page 1 or 2, and full-screen graphics or mixed text and 
graphics. 

Similar Applesoft Statements: The GR statement switches to mixed 
text and low-resolution graphics from page 1 and clears the graphics 
screen to black. The H G R statement switches to mixed text and high- 
resolution graphics from page 1 and clears the graphics screen to black. 
The HGR2 statement switches to full-screen high-resolution graphics 
from page 2 and clears the entire screen to black. 
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Displaying text 


POKE -16303» 0 


Full-screen graphics 


Mixed text and graphics 


Displaying page 1 


Switches the display from any form of graphics to full-screen text 
without resetting the text window. Depending on the setting of the 
applicable soft switch, the text displayed may be taken from low- 
resolution page 1 or page 2. 

The TEXT statement also switches to text display, but in addition se¬ 
lects page 1, resets the text window to the full screen, and positions the 
cursor in the bottom-left corner of the screen (column 1, row 24). 


POKE -16302 t 0 


Switches the display from mixed text and graphics to full-screen 
graphics. Depending on the settings of the other soft switches, the 
resulting display may be either low- or high-resolution graphics and 
may be taken from either page 1 or page 2. If full-screen text is cur¬ 
rently being displayed, there is no visible effect. 


POKE -16301» 0 


Switches the display from full-screen graphics to mixed text and 
graphics, with four lines of text at the bottom of the screen. Depend¬ 
ing on the settings of the other soft switches, the upper portion of the 
screen may show low- or high-resolution graphics, taken from either 
page 1 or page 2. The text displayed in the bottom four lines will be 
taken from the same page number as the graphics in the upper part 
of the screen. If full-screen text is currently being displayed, there is 
no visible effect. 


POKE -16300 t 0 

Switches the display from page 2 to page 1, without clearing the 
screen or moving the cursor. Depending on the settings of the other 
soft switches, the resulting display may be text or low-resolution 
graphics taken from low-resolution page 1, or high-resolution graph¬ 
ics taken from high-resolution page 1; if graphics, it may be either full¬ 
screen graphics or mixed with four lines of text from low-resolution 
page 1. 

Always execute this POKE statement before switching to Integer BASIC 
if you’ve been using page 2 in Applesoft; otherwise you’ll be left still look¬ 
ing at text (low-resolution) page 2 while Integer BASIC is writing its 
screen output to page 1. 
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POKE -16299» 0 

Displaying page 2 Switches the display from page 1 to page 2, without clearing the 

screen or moving the cursor. Depending on the settings of the other 
soft switches, the resulting display may be text or low-resolution 
graphics taken from low-resolution page 2, or high-resolution graph¬ 
ics taken from high-resolution page 2; if graphics, it may be either full¬ 
screen graphics or mixed with four lines of text from low-resolution 
page 2. 

POKE -16298 t 0 

Low-resolution graphics Switches from high- to low-resolution graphics, without clearing the 

screen. Depending on the settings of the other soft switches, the re¬ 
sulting display may be taken from low-resolution page 1 or page 2, 
and may be either full-screen low-resolution graphics or mixed with 
four lines of text from the same low-resolution page. If full-screen text 
is currently being displayed, there is no visible effect. 

Always execute this P 0 K E statement before switching to Integer BASIC 
if you’ve been using high-resolution graphics in Applesoft; otherwise In¬ 
teger BASIC’s G R statement will incorrectly display the high- instead of 
the low-resolution page. 


POKE - 16297 t 0 

High-resolution graphics Switches from low- to high-resolution graphics, without clearing the 

screen. Depending on the settings of the other soft switches, the re¬ 
sulting display may be taken from high-resolution page 1 or page 2, 
and may be either full-screen high-resolution graphics or mixed with 
four lines of text from the corresponding low-resolution page. If full¬ 
screen text is currently being displayed, there is no visible effect. 

CALL -1998 

Clearing the graphics display Clears low-resolution page 1 to black if displaying low-resolution 

graphics, or to black-on-white at-signs (@) if displaying text. If display¬ 
ing high-resolution graphics, or text or low-resolution graphics from 
page 2, there is no visible effect. 


CALL -1994 

Clears the upper 40 rows of low-resolution page 1 to black if display¬ 
ing low-resolution graphics, or the upper 20 lines to black-on-white 
at-signs (@) if displaying text. If displaying high-resolution graphics, 
or text or low-resolution graphics from page 2, there is no visible 
effect. 
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CALL -3086 

Clears the current high-resolution page to black. (Applesoft remem¬ 
bers which page you used last, regardless of the switch settings.) 

CALL -3082 

Clears the current high-resolution page to the color most recently 
used in an H P L 0 T statement. (Applesoft remembers which page 
you used last, regardless of the switch settings.) 

Miscellaneous Input and Output 

This section describes the special locations in the Apple lie’s mem¬ 
ory for controlling a variety of miscellaneous input and output de¬ 
vices: reading the buttons on the hand controls, controlling the 
annunciator outputs and the utility strobe, and producing sounds 
through the built-in speaker. 

The annunciators are four pins of the hand control connector that can 
each be set to either of two states (on or off). The utility strobe is another 
pin of the connector that is normally at + 5 volts but can be triggered to 
drop to zero volts for one-half microsecond. These features are typically 
used to control devices such as lamps and relays connected to the com¬ 
puter through the hand control connector. See th e Apple lie Reference 
Manual for further information. 


PEEK (-16287) 

Reading the hand control buttons Reads the button on hand control 0; yields a result > 127 if the but¬ 

ton is being pressed, < = 127 if it is not. The I dpen-apple | key on 
the Apple lie keyboard is equivalent to this button and can be read in 
the same way. 

PEEK (-16286) 

Reads the button on hand control 1; yields a result > 12 7 if the but¬ 
ton is being pressed, < = 127 if it is not. The | solid-apple | key on 
the Apple lie keyboard is equivalent to this button and can be read in 
the same way. 
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Controlling the annunciators 


PEEK (-16285) 

Reads the button on hand control 2; yields a result > 127 if the but¬ 
ton is being pressed, < = 12 7 if it is not. 

Notice that, although there are provisions for connecting four hand con¬ 
trols (numbered 0 to 3) to the computer, there is no way to read the but¬ 
ton on hand control 3. 


POKE - 16295 t 0 

Turns on annunciator output 0 (hand control connector, pin 15). 
POKE - 1S29G t 0 

Turns off annunciator output 0 (hand control connector, pin 15). 
POKE -16293 t 0 

Turns on annunciator output 1 (hand control connector, pin 14). 
POKE -16294 t 0 

Turns off annunciator output 1 (hand control connector, pin 14). 
POKE - 16291 t 0 

Turns on annunciator output 2 (hand control connector, pin 13). 
POKE - 16292 t 0 

Turns off annunciator output 2 (hand control connector, pin 13). 
POKE - 16289 t 0 

Turns on annunciator output 3 (hand control connector, pin 12). 
POKE -16290 f 0 

Turns off annunciator output 3 (hand control connector, pin 12). 
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PEEK (-16320) 

Controlling the utility strobe Triggers the utility strobe (hand control connector, pin 5). 

The utility strobe should always be controlled with P E E K, not with 
POKE. Using POKE triggers the strobe twice instead of once. See the 
Apple lie Reference Manual for further information. 


PEEK (-16336) 

Controlling the speaker Produces a single click from the built-in speaker; can be used in var¬ 

ious combinations and frequencies to produce musical tones and 
other sounds. 

The speaker should always be controlled with P E E K, not with POKE. 
Using P 0 K E produces two clicks instead of one. See the Apple lie Ref¬ 
erence Manual for further information. 


PEEK (-16352) 

Produces a single click on a cassette recording or on an audio ampli¬ 
fier connected to the cassette output jack via the amplifier’s auxiliary 
input jack; can be used in various combinations and frequencies to 
produce musical tones and other sounds. See Appendix M for further 
information on using a cassette recorder. 

Cassette output should always be controlled with P E E K, not with 
POKE. Using POKE produces two clicks instead of one. See the Apple 
lie Reference Manual for further information. 


Error Handling 

F.5 

This section describes the special locations associated with Apple¬ 
soft’s error handling mechanism. They can be used by user-supplied 
onerr goto statement: see Sec- error-handling routines established with the ONERR GOTO 
tlon 3 - 5 - 1 statement. See Section 3.5 and Appendix E for further information. 


PEEK (216) 

Yields a result > 127 if an error-handling routine has been estab¬ 
lished with the ONERR G0T0 statement, < = 127 if normal error 
handling is in effect. 
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Clearing the control stack 


POKE 216 t 0 

Restores Applesoft’s normal error-handling mechanism; cancels the 
effect of a previous ONERR GOTO statement. 


PEEK (222) 

After an error-handling routine has been called, yields the error code 
identifying the type of error detected. See Appendix E and Table 3-1 
(Section 3.5.1) for further information on error codes. 

Errors associated with the Disk Operating System (DOS) will also regis¬ 
ter at location 222; see the DOS manual for further information. 


PEEK (219) * 256 + PEEK (218) 

After an error-handling routine has been called, this expression 
yields the line number of the statement in which the error was 
detected. 


CALL -3288 

Clears from Applesoft’s internal control stack information placed 
there when an error-handling routine was called. Should be used be¬ 
fore exiting from any error-handling routine with a G 0 T 0 instead of a 
RESUME statement. 


CALL 54915 

Empties the internal control stack of all control information, without 
affecting the contents of any variables. 
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Appendix G 


G.1 


Hints for Program 
Efficiency 


The information in this appendix can help you write programs that run 
faster or use less memory space. Section G.1, “Saving Space,” gives 
tips you can follow if you need to conserve memory space. Section 
G.2, “Saving Time,” suggests ways to speed up program execution. 

Saving Space 

Serious programmers often keep two versions of their programs: one 
expanded and heavily documented with REM statements, the other 
“crunched” to use the minimum memory space. There are a number 
of utility programs on the market that will make Applesoft programs 
more compact. They work by automatically removing REM state¬ 
ments, combining several statements onto a single program line, and 
eliminating optional semicolons in PR I NT lists. Here are some tips 
for programmers who prefer to do the work themselves: 

• Use multiple statements per line. There is a small amount of 
overhead (5 bytes) associated with each line in the program. Two 
of these bytes contain the line number. This means that no matter 
how many digits you have in your line number (minimum line 
number is 0, maximum is B 39 3 3), it takes the same number of 
bytes (two). Putting as many statements as possible on each line 
will cut down on the number of bytes used by your program. (A 
single line can include up to 239 characters.) 

When combining statements into fewer lines, remember that when the 
condition in an I F...T HEN statement is false, execution continues with 
the next line and not necessarily with the next statement. 


If you’re counting bytes, remember to add in one byte for each colon 
used to separate statements. 
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Combining many statements on one line makes editing and other 
changes much more difficult. It also makes a program more difficult to 
read and understand, not only for others but also for you yourself when 
you return to the program later on. Use this technique only in programs 
with serious space limitations. 

• Delete all R E M statements. Each REM statement uses at least 

one byte (for the keyword REM itself), plus one byte for each 
character in the text of the remark. For instance, the statement 

REM THIS IS A REMARK 

occupies 18 bytes of memory. In the program line 

140 X - X + Y : REM UPDATE SUM 

the R E M uses 12 bytes of memory, plus one for the colon sepa¬ 
rating it from the preceding statement. 

Take care not to delete REM lines that are referred to by other lines. For 
example, if your program includes the lines 

200 GOTO 300 


300 REM THIS IS THE NEXT ROUTINE 

and you delete line 300, the program will halt with an UNDEF ' D 
STATEMENT error. 


Like programs with many statements on each line, those without de¬ 
tailed REM statements are difficult to read and understand, not only for 
others but also for you yourself when you return to the program later on. 

You should consider eliminating REM statements only when faced with 
a serious shortage of memory space. 

• Use integer instead of real arrays wherever possible (see Sec¬ 
tion H.2, “Applesoft Memory Allocation”). 

• Use variables instead of constants. Suppose you use the con¬ 
stant 3.1415 9 ten times in your program. If you insert a 
statement 

PI = 3♦14159 

and then use the variable PI instead of the constant 3.14159 
each time it is needed, you will save 40 bytes. This will also result 
in a speed improvement. 


Hints for Program Efficiency 














• Applesoft programs need not end with an E N D statement, so you 
can save a little space by omitting it. 

• Reuse the same variables. If you use a variable T to hold a tem¬ 
porary result in one part of the program and you need a tempo¬ 
rary variable later in your program, use T again. Or if you’re 
accepting a one-character input from the user in two different 
places in the program, use the same variable both times. 

• Use subroutines and functions when the same action must be 
performed at different places in the program, to avoid having to 
write the identical code more than once. 

• Use the zero elements of arrays—such as A < 0 ) or B ( 0 »X ) — 
since space is allocated for them anyway. 

• Semicolons are optional before and after T A B calls; leaving 
them out saves one byte per occurrence. 

• Semicolons between items in a P RIN T list are optional so long 
as the separate items are unambiguous. For instance, in line 50 
of the following example all items will be displayed separately (al¬ 
though concatenated), since the dollar signs at the ends of the 
string variable names make it clear they are three separate 
variables: 

10 LET A$ = "WELL, " 

20 LET B$ = "MARSHA, " 

30 LET C$ = "IT LOOKS LIKE " 

40 LET C = 10 

50 PRINT A$ B$ C$ "FRED IS "C" HOURS 
LATE!" 

This program will display 

WELL, MARSHA, IT LOOKS LIKE FRED IS 10 
HOURS LATE! 

But in this example several of the variables will be run together 
and interpreted as a single name: 


10 

LET 

A = 

5 

20 

LET 

B = 

10 

30 

LET 

Cl -- 

= 15 

40 

LET 

D = 

10 

50 

PRINT A 

B Cl 
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Applesoft interprets line 50 as saying “display the value of inte¬ 
ger variable ABCX, followed by the value of real variable D,” and 
will display 

010 

Since variable A B C 7., hasn’t been assigned a value, its value is 0. 

• If a quoted string is the last item in the last statement of a line, the 
closing quotation mark may be omitted, saving one byte: 

10 PRINT "THIS IS THE WAY THE WORLD 
ENDS > 

20 PRINT "NOT WITH A BANG BUT A 
WHIMPER 

This last technique should be used with caution: bad things can happen 
if the omitted quotation mark comes somewhere other than at the end of 
aline: 

10 PRINT "THIS WON'T WORK : PRINT "VERY 
WELL 

This line will display 

THIS WON'T WORK : PRINT 0 

The final 0 is the value of the undefined variable V E R Y W E L L. 


Saving Time 

Utility programs called compilers are now available that convert Ap¬ 
plesoft programs to a form in which they run far faster than normally. 
However, a compiled program can take as much as 50% more space 
than a non-compiled one. The hints listed below should improve the 
execution speed of your Applesoft programs. Notice that some of 
these same hints were given in Section G.1 to save memory space. 
This means that in many cases you can both shorten and speed up 
your programs at the same time. 

• This hint is probably ten times more important than any other in 
the list: use real variables wherever possible instead of integer 
variables or constants. It takes more time to convert an integer to 
its real-number representation than to fetch the value of a real 
variable. This technique is especially important within subrou¬ 
tines, loops, and other program segments that are executed 
repeatedly. 
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• Space for variables is allocated in the variable table in the order 
in which they are encountered during the execution of the pro¬ 
gram. A line such as 

5A = 0;B = A:C = B 

will place A first in the variable table, B second, and C third (as¬ 
suming this line is the first executed in the program). When these 
variables are referred to later in the program, Applesoft will have 
to search only one entry in the variable table to find A, two entries 
to find B, and three entries to find 0. Try to arrange for those vari¬ 
ables that your program refers to most often to be located as 
early as possible in the variable table. 

• Omit the index variable in N E X T statements. The statement 
NEXT 

is somewhat faster than 
NEXT I 

because no check needs to be made to see whether the variable 
named in the NEXT statement agrees with the index variable 
named in the corresponding FOR statement. 

• When Applesoft encounters a backward reference from a later 
line of the program to an earlier one, such as 

900 GOTO 100 

it scans the entire program from the beginning until it finds the 
desired line number (100, in this example). So you can speed 
things up by placing frequently-referenced lines as early in the 
program as possible. 


— 
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Appendix H 


Implementation Details 


This appendix contains information on various details of Applesoft’s 

internal operation: 

• Section H.1, “Apple lie Memory Map,” summarizes the use of 
memory in the Apple lie and identifies areas of memory reserved 
for system use. 

• Section H.2, “Applesoft Memory Allocation,” describes the way 
Applesoft allocates memory for program and variable storage. 

• Section H.3, “Zero Page Usage,” details Applesoft’s use of 
special locations in page zero of the Apple lie’s memory. 

• Section H.4, “Keyword Tokens,” lists the internal codes 
Applesoft uses to represent keywords occurring in a program. 
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Table H-1 Apple lie Memory Usage 


Apple He Memory Map 

H.1 

Table H-1 summarizes memory usage in the Apple lie. Addresses 
preceded by a dollar sign ($) are in hexadecimal; they are followed 
on the next line by their decimal equivalents. 


Memory Range 


From 

To 

Used for 

$0000 

o 

$ 0 1 F F 
511 

System workspace; not advisable to use 

$0200 

512 

$02FF 

767 

Keyboard character buffer 

$0300 

768 

$ 0 3 C F 
975 

Available for short machine-language programs 

$0300 

976 

$ 0 3 F F 
1023 

Used by DOS (available if you don’t use a disk drive) 

$0400 

1024 

$ 0 7 F F 
2047 

Low-resolution graphics and text display, page 1 

$0800 

2048 

$0BFF 

3071 

Low-resolution graphics and text display, page 2 

$0800 

2048 

$0XXX 

XXX 

Applesoft program and variable space, where XXX is the 
setting of H I M E M s. This may be set as high as 4 9151; 
must be less if using DOS or reserving part of memory for 
machine language routines or high-resolution display pages. 

$2000 

8192 

$3FFF 

16383 

High-resolution graphics display page 1 

$4000 

16384 

$5FFF 

24575 

High-resolution graphics display page 2 

$9600 

38400 

$BFFF 

49151 

DOS (Disk Operating System) 

$0000 

49152 

$CFFF 

53247 

Hardware I/O Addresses 

$0000 

53248 

$F7FF 

63487 

Applesoft 

$ F 8 0 0 
63488 

$FFFF 

65535 

Apple lie System Monitor 
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Applesoft Memory Allocation 

Figure H-1 shows how Applesoft allocates the memory space be¬ 
tween the start of program storage (normally $ 8 00 hexadecimal, 
2048 decimal) and the end of variable storage (determined by the 
setting of HIM E M :). The boundaries between areas may vary; the 
left column gives “pointer” addresses at which the current settings of 
the boundaries can be found. 


Figure H-1 Applesoft Memory Map 


start of program 
$0067—$0068 
103-104 

end of program 
$00AF—$00B0 
175-176 

start of variables 
$0069—$006A(LQMEM:) 
105-106 


start of arrays 
$006B—$0066 
107-108 

end of variables 
$ 0 0 6 D—$ 0 0 6 E 
109-110 


start of strings 
$006F—$0070 
111-112 

end of strings (HIME M :) 
$0073—$0074 
115-116 


PROGRAM 


SIMPLE 

VARIABLES 


ARRAYS 


FREE SPACE 


STRINGS 


normally $ 0 8 0 0 
(2048) 


Pointer addresses are given in hexadecimal first, followed by their 
decimal equivalents. All pointers are stored with the low-order byte 
first. Thus, for example, the address of the beginning of string space 
can be calculated with the Applesoft expression 

PEEK (112) * 25G + PEEK (111) 
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Figure H-2 shows how space is allocated for individual variables and 
arrays. Simple real, integer, or string variables use seven bytes each. 
Real variables use two bytes for the variable name and five for the 
value (one exponent, four mantissa, most significant first). Integer 
variables use two bytes for the variable name, two for the value, and 
have zeros in the remaining three bytes. String variables use two 
bytes for the variable name, one for the length of the string, two for a 
pointer to the contents of the string in memory, and have zeros in the 
remaining two bytes. 

Real arrays use a minimum of twelve bytes: two bytes for the array 
name, two for the size of the array in bytes, one for the number of di¬ 
mensions, two for each dimension, and five for each element of the 
array. Integer array variables use only two bytes for each element. 
String array variables use three bytes for each element: one for the 
length of the string and two for a pointer to its contents. Multidimen¬ 
sional arrays are stored with the first subscript varying fastest. 

String variables and arrays contain pointers (addresses) to the con¬ 
tents of the strings themselves, which are stored in order of creation 
from HIM E M : down, using one byte of memory for each character 
in the string. The pointer stored with the variable gives the address of 
the first character in the string. 

When a new function is defined by a D E F F N statement, 6 bytes 
are used to store the pointer to the definition. 

Reserved words occurring in a program are converted into one-byte 
tokens (see Section H.4, “Keyword Tokens”). All other characters in 
a program occupy one byte of program storage each. 

As a program is executed, space is allocated on the internal control 
stack as follows: 

• Each active F 0 R/N E X T loop uses 16 bytes. 

• Each active subroutine (one that has been called and has not yet 
returned) uses 6 bytes. 

• Each pai r of parentheses encountered in an expression uses 4 
bytes. 

• Each temporary result calculated in an expression uses 12 
bytes. 
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Figure H-2 Variable and Array Maps 




Simple Variables 




Real 

Integer 

String Pointers 

NAME 

(pos) 1 st byte 

NAME (neg) 1st byte 

NAME 

(pos) 1st byte 


(pos) 2nd byte 

(neg) 2nd byte 


(neg) 2nd byte 

exponent 

1 byte 

high byte 

length 

1 byte 

mantissa 

m.s. byte 

low byte 

address 

low byte 

mantissa 


0 

address 

high byte 

mantissa 


0 


0 

mantissa 

1. s. byte 

0 


0 



Array Variables 




Real 

Integer 

String Pointers 

NAME 

(pos) 1st byte 

NAME (neg) 1st byte 

NAME 

(pos) 1st byte 


(pos) 2nd byte 

(neg) 2nd byte 


(neg) 2nd byte 

OFFSET pointer to next 

OFFSET pointer to next 

OFFSET pointer to next 

variable: add to address of 

variable: add to address of 

variable: add to address of 

this variable name 

this variable name 

this variable name 


low byte 

low byte 


low byte 


high byte 

high byte 


high byte 

NO. OF DIMENSIONS 

NO. OF DIMENSIONS 

NO. OF DIMENSIONS 


1 byte 

1 byte 


1 byte 

SIZE Nth DIMENSION 

SIZE Nth DIMENSION 

SIZE Nth DIMENSION 


high byte 

high byte 


high byte 


low byte 

low byte 


low byte 


SIZE 1st DIMENSION 

SIZE 1st DIMENSION 

SIZE 1st DIMENSION 


high byte 

high byte 


high byte 


low byte 

low byte 


low byte 

REAL 

(0,0,..., 0) 

INTEGER% (0, 0,..., 0) 

STRINGS 

(0,0,..., 0) 

exponent 

1 byte 

high byte 

length 

1 byte 

mantissa 

m. s. byte 

low byte 

address 

low byte 

mantissa 



address 

high byte 

mantissa 

mantissa 

1. s. byte 




REAL 

(N, N,.. » , N) 

INTEGER% (N, N,..., N) 

STRINGS 

(N, N,..., N) 

exponent 

1 byte 

high byte 

length 

1 byte 

mantissa 

m. s. byte 

low byte 

address 

low byte 

mantissa 

mantissa 

mantissa 

1. s. byte 


address 

high byte 


m. s. = most significant 
I. s. = least significant 
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H.3 


Table H-2 Applesoft Zero Page Usage 


Zero Page Usage 

Table H-2 shows the locations that Applesoft uses in page zero of 
memory (locations $0000 through $00FF hexadecimal). Ad¬ 
dresses are given first in hexadecimal, then in decimal. All pointers 
(memory addresses) are stored in the usual 6502 style, low-order 
byte first. To find the value of a pointer, use the Applesoft expression 

PEEK (SECNDADDR) * 25B + PEEK 
(FIRSTADDR) 

where FIRST ADDR and SECNDADDR are the addresses of the 
two bytes of the pointer itself. 


Location(s) 


Used for 


$0000 

- 

$0005 

0 

- 

5 

$ 0 0 0 A 

_ 

$oooc 

10 

- 

12 

$0000 

_ 

$0017 

13 

- 

23 

$0020 

_ 

$ 0 0 4 F 

32 

- 

79 

$0050 

_ 

$0061 

80 

- 

97 

$0062 

_ 

$0066 

98 

- 

102 

$0067 

_ 

$0068 

103 

- 

104 

$0069 

_ 

$ 0 0 6 A 

105 

— 

106 

$ 0 0 6 B 

_ 

$0066 

107 

- 

108 

$ 0 0 6 D 

— 

$ 0 0 6 E 

109 

- 

110 

$ 0 0 6 F 

_ 

$0070 

1 1 1 

- 

112 

$0071 

— 

$0072 

113 

- 

114 

$0073 

_ 

$0074 

115 

- 

116 


Jump instructions to continue in Applesoft 


Jump instruction for U S R function (see Section 7.1.4) 


General purpose counters/flags for Applesoft 


Reserved for system Monitor program 


General purpose pointers for Applesoft 


Result of last multiply or divide 


Pointer to beginning of program. Normally set to $ 0 801. 


Pointer to start of simple variable space. Also points to the 
end of the program plus 1 or 2, unless changed with the 
L 0 M E M : statement. 

Pointer to start of array space 
Pointer to end of array space 

Pointer to start of string start. Strings are stored from here to 
value of HI MEM:. 

General pointer 

Highest location in memory available to Applesoft plus one. 
On initial entry to Applesoft, set to the highest RAM memory 
location available. 
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Location(s) 


Used for 


$0075 

- 

$0078 

Line number of line currently being executed 

117 

— 

118 


$0077 

_ 

$0078 

“Old line number” at which execution was interrupted by 

119 

- 

120 

END, 8T0P,or| control |-0 

$0079 

— 

$007 A 

“Old text pointer.” Location in memory of statement to be 

121 

— 

122 

executed next 

$ 0 0 7 B 

— 

$0078 

Line number of D A T A statement containing next item for 

123 

- 

124 

READ 

$0070 

— 

$007E 

Absolute memory location of next item for R E A 0 

125 

- 

128 


$ 0 0 7 F 

_ 

$0080 

Pointer to current source of IN P U T. Set to $ 0 2 01 during 

127 

~ 

128 

an INPUT statement. During a R E A 0 statement, set to 
the DAT A item being read. 

$0091 

_ 

$0082 

Name of last-used variable 

129 

- 

130 


$0083 

_ 

$0084 

Pointer to value of last-used variable 

131 

- 

132 


$0085 

_ 

$0098 

General use 

133 

- 

158 


$0090 

— 

$ 0 0 A 3 

Main floating-point accumulator 

157 

- 

183 


$00 A 4 



General use in floating-point arithmetic 

184 




$00 A 5 

_ 

$ 0 0 A B 

Secondary floating-point accumulator 

165 

— 

171 


$ 0 0 A C 

_ 

$ 0 0 A E 

General use flags/pointers 

172 

- 

174 


$ 0 0 A F 

— 

$ 0 0 B 0 

Pointer to end of program (not changed by L 0 M E M :) 

175 

— 

178 


$ 0 0 B 1 

— 

$0088 

Character input routine. Applesoft calls here every time it 

177 

- 

200 

wants another character. 

$ 0 0 B 8 

— 

$ 0 0 B 9 

Pointer to last character obtained through character input 

184 

— 

185 

routine 

$0089 

_ 

$ 0 0 8 D 

Random number 

201 

- 

205 


$0000 

— 

$0005 

High-resolution graphics scratch pointers 

208 

- 

213 


$0008 

_ 

$ 0 0 0 F 

0 N E R R pointers/scratch 

218 

- 

223 


$ 0 0 E 0 

_ 

$ 0 0 E 2 

High-resolution graphics horizontal and vertical coordinates 

224 

- 

226 
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Table H-2 continued 


Table H-3 Applesoft Keyword Tokens 


Location(s) Used for 


$ 0 0 E 4 
228 


High-resolution graphics color code 

$ 0 0 E 5 - 
228 - 

$ 0 0 E 7 
231 

General use for high-resolution graphics 

$00E6 

230 


Current high-resolution page being drawn on (decimal 32 if 
page 1; decimal 8 4 if page 2) 

$00E8 - 
232 - 

$ 0 0 E 8 
233 

Pointer to beginning of shape table 

$00F0 - 
240 - 

$ 0 0 F 3 
243 

General use flags 

$00F4 - 
244 - 

$ 0 0 F 8 
248 

ONERR pointers 


Keyword Tokens 

Applesoft tokenizes all its key words; that is, it converts them to one- 
byte codes called tokens to save memory space. Table H-3 gives a 
list of the tokens representing the various keywords. 


Hex 

Dec 

Keyword 

$80 

128 

END 

$81 

120 

FOR 

$82 

130 

NEXT 

$83 

131 

DATA 

$84 

132 

INPUT 

$85 

133 

DEL 

$88 

134 

DIN 

$87 

135 

READ 

$88 

138 

GR 

$80 

137 

TEXT 

$8A 

138 

PR# 

$8B 

130 

IN# 

$8C 

140 

CALL 

$8D 

141 

PLOT 


Hex 

Dec 

Keyword 

$8E 

142 

HLIN 

$8F 

143 

ULIN 

$00 

144 

HGR2 

$01 

145 

HGR 

$02 

148 

HCOLOR = 

$03 

147 

HPLOT 

$04 

148 

DRAN 

$05 

140 

XDRAN 

$08 

150 

HTAB 

$07 

151 

HOME 

$08 

152 

ROT = 

$00 

153 

SCALE = 

$0 A 

154 

SHLOAD 

$0B 

155 

TRACE 
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Table H-3 continued 


Hex 

Dec 

Keyword 

$9C 

IBS 

NOTRACE 

$0D 

157 

NORMAL 

$9E 

158 

INVERSE 

*9F 

159 

FLASH 

$A0 

ISO 

COLOR = 

$ A 1 

1 G 1 

POP 

$A2 

1G2 

VTAB 

$A3 

1G3 

HIMEM: 

$ A4 

164 

LOMEM: 

$A5 

1 65 

ONERR 

$AG 

16G 

RESUME 

$A7 

1G7 

RECALL 

$ AS 

168 

STORE 

$A9 

169 

S PEED = 

$ AA 

170 

LET 

$AB 

171 

GOTO 

$AC 

172 

RUN 

$ AD 

173 

IF 

$AE 

174 

RESTORE 

$AF 

175 

&: 

$B0 

176 

GOSUB 

$B 1 

177 

RETURN 

$B2 

178 

REM 

$B3 

179 

STOP 

$B4 

180 

ON 

$B5 

181 

WAIT 

$BS 

182 

LOAD 

$B7 

183 

SAVE 

$B8 

184 

DEF 

$B9 

185 

POKE 

$BA 

186 

PRINT 


Hex 

Dec 

Keyword 

$BB 

187 

CONT 

$BC 

188 

LIST 

$BD 

189 

CLEAR 

$BE 

190 

GET 

$BF 

191 

NEW 

$C0 

192 

TAB 

$C1 

193 

TO 

$C2 

194 

FN 

$C3 

195 

SPC 

$C4 

196 

THEN 

$C5 

197 

AT 

$C6 

198 

NOT 

$C7 

199 

STEP 

$C8 

200 

+ 

$C9 

201 

- 

$CA 

202 

* 

$CB 

203 

/ 

$CC 

204 

- 

$CD 

205 

AND 

$CE 

206 

OR 

$CF 

207 

> 

$D0 

208 

= 

$D1 

209 

< 

$D2 

210 

SGN 

$D3 

211 

INT 

$D4 

212 

ABS 

$D5 

213 

USR 

$DG 

214 

FRE 

$D7 

215 

SCRN 

$D8 

216 

PDL 

$D9 

217 

POS 
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Table H-3 continued 


Hex 

Dec 

Keyword 

$DA 

218 

SQR 

$DB 

219 

RND 

$DC 

220 

LOG 

$DD 

221 

EXP 

$DE 

222 

COS 

$DF 

223 

SIN 

$E0 

22 a 

TAN 

$E1 

225 

ATN 

$E2 

22B 

PEEK 


Hex 

Dec 

Keyword 

$E3 

227 

LEN 

*E4 

228 

STR$ 

$E5 

229 

OAL 

$EG 

230 

ASC 

$E7 

231 

CHR$ 

$E8 

232 

LEFT $ 

$E9 

233 

RIGHT$ 

$EA 

234 

M I D$ 
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Appendix I 


Ranges of numeric values 


All arithmetic done on reals 


truncate: to convert a real number to the 
next lowest integer 


Display Formats for 
Numbers 


This appendix describes the formats in which Applesoft displays or 
prints numeric values. Numbers may not always be formatted in the 
way you might expect; this is particularly true for numbers more than 
9 digits long or for exceptionally small numbers. 

Numeric values in Applesoft must be in the range — 1 * i 0 " 3 8 to 
1 * i 0 - 3 8. Any number whose absolute value is less than approxi¬ 
mately 3 * 10 * - 3 3 is converted to zero. True integer values to be 
assigned to integer variables (such as A%) must be in the range 
— 327S7to +327G7. 

A number typed from the keyboard or a numeric constant used in 
an Applesoft program may have as many as 38 digits. However, 
only nine digits are significant, and the last digit is rounded off. An 
Applesoft statement that you type as 

PRINT 1.23458787854321 

—you type this from the 
keyboard 


will display 

1.23458788 —you get this on the screen 

on the screen. 

Integers are always converted to real form before being used in arith¬ 
metic calculations, and the results are converted back to integer form 
when assigned to an integer variable. Conversion from real to integer 
form is by truncation to the next lowest integer, not by rounding to the 
nearest integer. 
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Rules for number formats 


scientific notation: the representation 
of numbers in terms of powers of 10 


Table 1-1 Number Formats 


Applesoft displays and prints numbers according to the following 

rules: 

• If the number is negative, it is preceded by a minus sign (-); if it is 
zero or positive, no sign is used. 

• If the number is an integer with an absolute value from 0 to 
993 999 999, it is formatted as an integer. 

• If the number is not an integer and its absolute value is between 
♦ 01 and 999 999 999 ♦ 2, it is formatted with a decimal 
point in the usual way. 

• in all other cases, the number is formatted in scientific notation 
(see below). 


Table 1-1 shows examples of the formats used for displaying and 
printing numbers. 


Number 

Output Format 

+ 1 

1 

-1 

- 1 

6523 

S523 

-23.460 

—23*49 

45.72* 10 *5 

4572000 

1 * 10"20 

IE+ 20 

-12.34567896* lO MO 

- 1♦2345S79E + 

1000000000 

IE+ 09 

999999999 

999999999 
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Figure 1-1 Format for Scientific Notation 


sign exponent symbol 


SX.XXXXXXXXESDD 



each X is a digit 


The format Applesoft uses for scientific notation is shown in Figure 1-1. 

A sign is shown only if the number is negative. There is always ex¬ 
actly one nonzero digit before the decimal point and up to eight digits 
after it, with trailing zeros suppressed. There are never any leading 
zeros; the digit before the decimal point is always nonzero. If there is 
only one digit to print after all trailing zeros are suppressed, no deci¬ 
mal point is shown. The letter E (for “exponent”) is always followed 
by a sign and a two-digit exponent. The value of a number repre¬ 
sented in this form is the number before the E times 10 raised to the 
power after the E. For example, 


sign of exponent_I 

digits of exponent_ 


PRINT 35 * 345 “ 14 yields 1 . 18450085E + 37 
PRINT -3.14153 * 587 A 5 

yields-1.84104BB8E+14 
PRINT 1 / 993 yields 1.00100IE-03 

PRINT -3 / 999 yields-3.003003E-03 
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Appendix J 


On-Screen Editing and 
Cursor Control 


The figures and tables below summarize Applesoft’s facilities for on¬ 
screen editing and cursor control. These features are discussed 
briefly in Section 1.4, “Editing What You Type,” and at greater length 
in the Apple lie Owner’s Manual and the Apple lie Applesoft Tutorial. 

If you have the Apple lie 80-Column Text Card installed in your 
computer, additional escape-mode features are available; see the 
80-Column Text Card Manual. 


Figure J-1 Single Cursor Moves 


Figure J-2 Long-range Cursor Moves 


D 



I 
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| LEFT-ARROW [ 

| RIGHT-ftRRON [ 

|UP-ARRON | 

| DOWN-ARROW 1 


8 

| CONTROL |-H 

21 

[ CONTROL |-U 

11 

| CONTROL |-K 

10 

| CONTROL |-J 


Table J-2 Escape-Mode Functions 


Key Function 

A Moves cursor right one position; leaves escape mode 

B Moves cursor left one position; leaves escape mode 

C Moves cursor down one line; leaves escape mode 

D Moves cursor up one line; leaves escape mode 

I Moves cursor up one line; remains in escape mode 

J Moves cursor left one position; remains in escape mode 

K Moves cursor right one position; remains in escape mode 

M Moves cursor down one line; remains in escape mode 


1 LEFT-ARROW [ 

| RIGHT-ARROW | 

|UP-ARROW | 

|DOWN-ARROW [ 


Moves cursor left one position; remains in escape mode 
Moves cursor right one position; remains in escape mode 
Moves cursor up one line; remains in escape mode 
Moves cursor down one line; remains in escape mode 


E Clears from cursor to end of line; leaves escape mode 

F Clears from cursor to end of text window; leaves escape mode 

@ Clears entire text window; moves cursor to top-left corner; leaves 

escape mode 
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Appendix K 


40/80-Column Display 
Differences 


The following chart summarizes the differences in the Apple lie’s be¬ 
havior with and without the Apple lie 80-Column Text Card installed. 
Notice that even 40-column display behaves somewhat differently 
with the 80-Column Text Card installed and active than without it. See 
Table K-i 40/80-Column Display t he 80-Column Text Card Manual for further information. 



Escape 

Mode 

Inverse 

Inverse 

Home 

Flash 

Comma 

Tabbing 

HTAB 

Card Inactive: 

40-Column 

Display 

Checkerboard 

cursor 

Uppercase 
characters only 

Clears text 
window 
to black; 
characters 
displayed in 
inverse 

Uppercase 
characters only 

Available 

Available 

Card Active: 

40-Column 

Display 

Plus-sign 

cursor; 

additional 

escape-mode 

features 

available 

Upper- and 
lowercase 

Clears text 
window 
to white; 
characters 
displayed 
in black 

Not available 

* * * 

DO NOT USE 

Available 

Available 

Card Active: 

80-Column 

Display 

Plus-sign 

cursor; 

additional 

escape-mode 

features 

available 

Upper- and 
lowercase 

Clears text 
window 
to white; 
characters 
displayed 
in black 

Not available 

* * * 

DO NOT USE 

Not available 
for second 

40 columns 

Not available 
for second 

40 columns; use 
POKE 36 » XX 
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y 

■ 

u 

u 

y 

L 

y 

y 

y 

u 

L 

u 

L 

■ 

u 

u 

y 

y 

u 

y 

y 

y 

y 

y 

y 
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Appendix L 


Comparison with Integer 
BASIC 


This appendix summarizes the differences between Applesoft and 
Apple’s earlier Integer BASIC language. Section L.3 gives some hints 
on converting programs written in Integer or other versions of BASIC 
to Applesoft. 

If Integer BASIC is loaded into your computer’s memory, you can 
switch from Applesoft to Integer BASIC by typing the command 

INT 

To switch from Integer BASIC to Applesoft, type 
FP 

F P stands for “floating-point," the name for the internal format used by 
languages like Applesoft to represent real numbers. 
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Differences between Features 

L.1 

Table L-1 lists Applesoft statements and functions that are not avail- 

Table L-1 Applesoft Features Not Avail- able in Integer BASIC, 
able in Integer BASIC 


ATN 

CHR$ COS 

DATA DEF FN DRAW 

EXP 

FLASH FN FRE 
GET 

HCOLOR = HGR HGR2 HIMEM: HOME HPLOT 

INT INVERSE 

LEFT $ LOG LOMEM: 

M I D$ 

NORMAL 

ON...GOSUB ON...GOTO ONERR GOTO 
POS 


READ 

RECALL 

RESTORE 

RESUME RIGHT $ 

ROT = 



SCALE = 

SHLOAD 

SIN 

SPC S PEED = SQR 

STOP 

STORE 

STR$ 


TAN 

USR 

UAL 

WAIT 

XDRAW 


Table L-2 lists Integer BASIC statements and functions that are not 

Table L-2 Integer BASIC Features Not available in Applesoft. 

Available in Applesoft 


AUTO 

DSP 

MAN 

MOD 
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Table L-3 Applesoft Features Expressed 
Differently in Integer BASIC 


Table L-3 lists Applesoft features that are expressed or accomplished 
differently in Integer BASIC. 


Applesoft 

Integer BASIC 

CLEAR 

CLR 

CONT 

CON 

HTAB 

TAB 

ON X GOTO 110* 120 * 130 

GOTO 100 + 10 * X 

ON X GOSUB 1100* 1200* 1300 

GOSUB 1000 + 100 * X 

HOME 

CALL — 93B 

INUERSE 

POKE 50* 127 

NORMAL 

POKE 50 * 255 

FLASH 

POKE 50 * S3 


XX (integer variable) X 

<> or >< # 


Other Differences 

As the name implies, the only numbers Integer BASIC can deal with 
are integers (whole numbers). Real variables and constants (num¬ 
bers with decimal points or exponents) are available in Applesoft but 
not in Integer BASIC. 

In Integer BASIC, the correctness of a statement’s syntax is checked 
when the statement is typed (when you press the I return | key). In 
Applesoft, such checking is not done until the statement is executed. 

Integer BASIC permits the line number in a GOTO or GO SUB 
statement to be specified by an arithmetic variable or expression; in 
Applesoft it may be specified only by an actual line number. 

In Applesoft, only the first two characters in a variable name are sig¬ 
nificant (for example, GOOD and G 0 U G E are recognized as the 
same variable). In Integer BASIC, all characters in a variable name 
are significant. 

String operations are defined differently in the two languages. In 
Integer BASIC, both strings and arrays must be defined in a DIM 
statement; in Applesoft, only arrays must be so defined. 
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Applesoft arrays may be multidimensional; Integer BASIC arrays are 
limited to one dimension. There are no string arrays in Integer 
BASIC. 

Applesoft automatically sets all array elements to zero or the null 
string on executing RUN or CLEAR.In Integer BASIC, your program 
must explicitly set all array elements to their initial values. 

In Integer BASIC, ifthe condition specified in an IF...THEN state¬ 
ment is false, only the T H E N portion of that statement is skipped. In 
Applesoft, all statements following the keyword THEN on the re¬ 
mainder of the same program line are skipped; program execution 
proceeds with the next numbered line. 

In Applesoft, the T R A C E statement displays the line number of each 
individual statement executed; in Integer BASIC, the line number is 
displayed just once for each program line. 

In Applesoft, PEEK, POKE, and CALL may use the true range of 
memory addresses (0 to G5535). In Integer BASIC, locations with 
addresses greater than 3 2 7 G 7 must be referred to by their corre¬ 
sponding negative values (location 3 2 7 G B is called - 32 7 G 7 - 1; 
32769 is called -327G7; 32770 is called -3276G;andsoon). 

If control reaches the end of an Integer BASIC program without an 
END statement having been executed, an error message is dis¬ 
played ; in Applesoft, the E N D statement at the end of a program is 
optional. 

In Integer BASIC, every NEXT statement must include a variable 
name; in Applesoft, the variable name is optional. 

In the Integer BASIC INPUT statement, the string representing the 
optional prompting message is followed by a comma, not a semi¬ 
colon as in Applesoft. If the first variable in the IN P U T list is an arith¬ 
metic (integer) variable, a question mark (?) is displayed whether the 
optional prompting string is present or not; if the first variable in the 
list is a string variable, no question mark is displayed, again whether 
the prompting string is present or not. In Applesoft, the question mark 
is displayed only if no prompting string is specified. 
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Converting BASIC Programs to Applesoft 

Although different versions of BASIC are generally similar, there are 
some incompatibilities that you should know about if you’re planning 
to convert programs to Applesoft from Integer or other versions of 
BASIC. Here are some things to watch for: 

• Some versions of BASIC use square brackets [ ] to denote 
array subscripts; Applesoft uses parentheses ( ). 

• Many versions of BASIC require that you define the lengths of all 
strings in DIM statements before you use them. In converting a 
program to Applesoft, remove all such DIM statements for 
strings; use DIM only to define arrays. In some of these other 
versions of BASIC, a statement of the form 

DIM A$ (I * J) 

defines a string array of J elements, each of length I. Convert 
DIM statements of this type to 

DIM A$(J) 

• Some versions of BASIC use a comma (>) or an ampersand (&) 
for string concatenation; Applesoft uses a plus sign (+). 

• Applesoft uses the string functions LEFT$,MID$, and 

RI GHT$ to extract substrings. Other versions of BASIC (such 
as Integer BASIC) use the expression 

A$ ( I ) 

to refer to character number I of string A $, and 
A$ (I t J) 

to designate the substring of A $ from character number I to 
character number J. These expressions occurring on the right 
side of an assignment statement can be converted to Applesoft 
as follows: 

Convert A$ (I) 

to M ID$ ( A$ t It 1 ) 

Convert A$ (I » J) 

to MID$(A$ » I t J - I + 1 ) 
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When these expressions occur on the left side of an assignment 
statement, convert them as follows: 


Convert 

A$< I ) 

= X$ 






to 

A$ = 

LEFT $(A$» 

I - 

1 ) 

+ 

X$ 

+ 



MI D$ (A*» 

I + 

1 ) 




Convert 

A$ ( I 

» J) = X* 






to 

A$ = 

LEFT$(A$ * 

I - 

1 ) 

+ 

X$ 

+ 



M I D$( A$ t J 

+ 

1 ) 





• Some versions of BASIC allow “multiple assignment” statements 
of the form 

LET B = C = 0 

This statement would set both variables B and C to 0. 

In Applesoft, such a statement has an entirely different effect: all 
equal signs after the first are interpreted as logical comparison 
operators. Thus the statement above will set variable B to 1 
(meaning “true”) if C equals 0, to 0 (meaning “false”) if it 
doesn’t. 

To convert such a multiple assignment statement into Applesoft, 
rewrite it as 

C = 0 : B = C 

or 

B = 0 : C = 0 

• Some verions of BASIC use a slash (/) instead of a colon (:) to 
separate multiple statements on the same line. In converting to 
Applesoft, change each such slash to a colon. 

• Programs that use the M A T (matrix arithmetic) functions avail¬ 
able in some versions of BASIC will have to be rewritten using 
F 0 R/N E X T loops to perform the corresponding matrix 
operations. 
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| control ] - [ reset | : see Section 1.3.2 


M.1 


SAME writes a program to tape 


Appendix M 

If You Have a Cassette 
Recorder 


This appendix discusses Applesoft’s facilities for storing programs 
and information on tape cassettes. For any of these features to work, 
all of the following conditions must be present: 

• There must be a cassette tape recorder properly connected to 
the computer. 

• The tape recorder must be turned on. 

• There must be a tape cassette properly mounted in the recorder. 

• The recorder must be set to “record” or “play,” depending on the 
statement being executed. 

None of the Applesoft tape operations checks for these conditions; if any 
of the cond itions doesn’t hold, the system may hang indefinitely. Only 
| control | - | reset l ean interrupt a tape operation; only God can make 
a tree. 

The SAME Command 

SAME 


The SAME command writes the Applesoft program currently in 
memory onto a tape cassette. No prompting message or signal of 
any kind is given; the tape recorder must already be turned on and 
set to “record” at the time the SAME command is executed. Beeps 
signal the start and end of the recording. 

Occasionally a tape recorder will not work properly when both input and 
output cables are plugged in at the same time. This problem originates 
from a ground loop in the tape recorder itself, which prevents making a 
good recording. The easiest solution is to unplug the output cable (usu¬ 
ally labeled “monitor" on the tape recorder) when recording. Such a 
ground loop causes no trouble when reading a tape. 
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M.2 

If your system is equipped with a disk drive and you have the Disk Oper¬ 
ating System (DOS) loaded and running, a SAME command with a 
name following the keyword S A M E will write the current program onto a 
disk under that file name. See Section 1.2.5 and your DOS manual for 
more information. 

The LOAD Command 

LOAD 

LOAD reads a program from tape 

The LOAD command reads an Applesoft program into memory from 
a tape cassette. No prompting message or signal of any kind is given; 
the tape recorder must already be turned on and set to “play” at the 
time the L 0 A D command is executed. A beep signals when the be¬ 
ginning of information is detected on the tape; a second beep is 
sounded when the program has been successfully loaded. 

If your system is equipped with a disk drive and you have the Disk Oper¬ 
ating System (DOS) loaded and running, a LOAD command with a 
name following the keyword L 0 A D will read a program from a disk 
under that file name. See Section 1.2.6 and your DOS manual for more 
information. 

M.3 

The STORE Statement 

STORE MX 

STORE writes an array to tape 

The STORE statement writes the contents of an integer or real array 
onto a tape cassette. The name of the array (MX in the example 
above) follows the keyword STORE, without a subscript. No prompt¬ 
ing message or signal of any kind is given; the tape recorder must 
already be turned on and set to “record” at the time the S T 0 R E 
statement is executed. Beeps signal the start and end of the 
recording. 

String arrays cannot be written with the STORE statement. 

M.4 

The RECALL Statement 

RECALL MX 

RECALL reads an array from tape 

The RECALL statement reads information into an integer or real ar¬ 
ray from a tape cassette. The name of the array (MX in the example 
above) follows the keyword RECALL, without a subscript. The des¬ 
ignated array must have been previously defined in a DIM statement 
in the program issuing the R E C A L L. 
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M.5 


S H L 0 A D reads a shape table from 
tape 


shape tables: see Section 6.3 


No prompting message or signal of any kind is given; the tape re¬ 
corder must already be turned on and set to “play” at the time the 
RECALL statement is executed. A beep signals when the beginning 
of information is detected on the tape; a second beep is sounded 
when the information has been successfully transferred. 

String arrays cannot be read with the RECALL statement. 

The name of the array read with RECALL need not be the same name 
used in the S TOR E statement that wrote the information onto the tape. 
However, the dimensions of the array being read should be the same as 
those of the array originally written. For example, if the tape was written 
by the statement 

STORE A 

where array A had been defined by 
DIM A (5 > 5 » 5) 
it can be read back with the statement 
RECALL B 

where array B is defined by 
DIM B (5 * 5 * 5) 

If the dimensions of the two arrays differ, RECALLmay scramble the in¬ 
formation read into array B, or the program may halt with the message 

?OUT OF MEMORY ERROR 

The SHLOAD Statement 

SHLOAD 


The SHLOAD (for “shape load”) statement reads a shape table into 
memory from a tape cassette. The shape table is loaded just below 
the current setting of HI MEM : (see Section 7.2.1, “The HI MEM : 
Statement”) and HI M E M : is reset to just below the shape table to 
protect it. 

No prompting message or signal of any kind is given; the tape re¬ 
corder must already be turned on and set to “play” at the time the 
SHLOAD command is executed. A beep signals when the beginning 
of information is detected on the tape; a second beep is sounded 
when the shape table has been successfully loaded. 

See Section 6.3 for extensive information on shape tables. 
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Appendix N 


Complete Listing of the 
Postage Rates Program 


Below is a complete listing of the postage rates program developed in 
Chapter 8. A copy of this program is included on the APPLESOFT 
SAMPLER disk. 


10 

20 

30 

40 

50 


SO 

70 

100 


110 

120 

130 

140 

150 

ISO 

170 

180 

190 

200 

210 


REM POSTAGE RATES—name of program 
: —colon leaves line empty 

REM DETERMINES POSTAGE FEES 

—what program does 

REM FOR EXPRESS> 1ST CLASS t 
REM AND PRIORITY MAIL 

—empty line inserted by embed¬ 
ding OcontroTJ-J (linefeed) 
at end of R E M statement in 
line 50 

REM 029/01/82 —number and date of this 

version 

REM BY JOHN SCR IBBLEMONGER 

—programmer’s credit line 
REM MENU OF POSTAGE CLASSES 

— | control | -J here 


HOME —begin with a clear screen 

TITLE$ = "POSTAGE RATES" 

PRINT 

HTAB 21-LEN < TITLE$) / 2 


—formula to center title 


PRINT 

TITLE$ 

OTAB S 
PRINT 

" 1 . 

EXPRESS" 

PRINT 

ii o 
jL. ♦ 

FIRST CLASS" 

PRINT 

"3. 

PRIORITY" 

PRINT 

PRINT 

"4. 

END THE PROGRAM 


I! 


—the escape hatch 
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300 REM — 1 control 1 -J here 

GET CLASS OF MAIL 


310 UTAB 14 

320 PRINT "Press the 

choice:"; 

330 GET C$ 


— | control | -J here 

number of your 
—semicolon keeps response on 
same line 

—only one keypress needed; 
cuts down on error possibili¬ 
ties. Note use of string variable 
to get number; avoids type 
mismatch errors 
— | control | -J here 


335 REM 

CHECK FOR VALIDITY 

—another 1 control | -J (last 
time this is noted) 


340 IF C$ = "4" THEN END 

—end program if user types a 4 
350 IF OAL (C$) > 0 AND UAL <C$) < 4 

THEN 380 —skip next two lines if valid 

choice typed 

3S0 PRINT CHR$(7)5 CHR$(7)S 


370 GOTO 330 
380 PRINT C$ 

380 C = UAL <C$) 

500 REM 

GET WEIGHT OF 


—beep twice to get attention 
—response was invalid; try 
again 

—since choice accepted via 
GET, it isn’t displayed on the 
screen. Display it back to user 
—need this value later to deter¬ 
mine what section of program 
to branch to for proper 
processing 

ITEM 


505 UTAB IB 


510 


520 


PRINT "PI 
numbe r 
P (for 
RETURN 


CALL -868 


ease enter the WEIGHT - a 
plus an 0 (for ounces) or a 
pounds) - and press the 
key: "5 —prompting message to tell 

user what information to type 
and how to type it 
—clear to end of line; useful to 
erase any errors that might be 
typed 
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530 INPUT ""5 W$ —semicolon suppresses ques¬ 

tion mark 

540 Ul« = RIGHT* (W$* 1) 

—rightmost letter should be 
either 0 or P; use it later to see 
if weight is consistent with 
postal regulations 

550 W = V A L (W$) —how many ounces or pounds? 

555 REM 

WAS ENTERED WEIGHT VALID? 

5S0 IF W > 0 AND <W1$ = " 0 11 OR Ml* = 
"P") THEN 710 —if a weight was typed, and if 

last character was either 0 for 
ounces or P for pounds, then 
proceed 

570 PRINT CHR$ (7)5 CHR$ (7) 

—beep twice to get attention 

580 GOTO 500 —entry was invalid; try again 

700 REM 

CHECK CONSISTENCY 

710 ON C GOSUB 10000* 11000* 12000 

—branch to appropriate subrou¬ 
tine to see if weight typed is 
within postal rules or program 
limitations for mail class 
chosen 

720 IF NOT EFLAG THEN 910 


—if no inconsistency detected in 
subroutine then proceed with 
processing 


730 

GOSUB 

S0000 

: REM KEYSTALL 

—wait for user to acknowledge 
message 

740 

EFLAG 

= 0 

—clear error flag set in 
subroutine 

750 

CLEAR 


—reset all variables, clear 
arrays, etc. 

7G0 

900 

GOTO 

REM 

100 

—restart program loop 


FIND APPROPRIATE CODE FOR 
PROCESSING —everything is valid and consis¬ 

tent; now program can solve 
for the postage rate! 
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910 

920 

930 

935 

940 

950 

990 

970 

999 

1000 

1010 


1020 


1030 

2000 


2010 


2020 

3000 


3010 


ON C GOSUB 1000* 2000* 3000 

—branch to proper calculating 
routine 

GOSUB 91000 : REM FORMATTER 

—format result for display 

PRINT 

REM 

DISPLAY RESULTS 


PRINT "POSTAGE 

NEEDED: $"5 T$ 

GOSUB 90000 : 

—finally, the postage due! 

REM KEYSTALL 

CLEAR 

—don’t go on until user is ready 
—prepare for restart... 

GOTO 100 

—...and do it 

REM 

SUBROUTINES 

BEGIN HERE 

REM 

EXPRESS MAIL CALCULATION 

W = INT <W + 

.99) 

T = R (W) 

—weight must be increased to 
compensate for fractions; 
postal rates read “NOT MORE 
THAN x POUNDS” 

—rate array filled in express mail 

RETURN 

consistency-checking routine 
(line 10000) 

—end routine 


REM 

FIRST CLASS CALCULATION 

T = .20 + I NT <W + .99 - 1) * .17 

—first class rate is 20 cents first 
ounce plus 17 cents for each 
additional ounce or portion 
thereof (April, 1982 rates) 

RETURN —end routine 

REM 

PRIORITY MAIL CALCULATION 

W = INT <W + .99) 

—compensate for partial ounces 
or pounds 


304 


Complete Listing of the Postage Rates Program 









3020 IF W > 10 THEN 31 GO 

—go to line 31G 0 for weights 
greater than 10 pounds 
(ounce weights converted to 
pounds in consistency subrou¬ 
tine starting at line 12000) 

3025 REM 

PRIORITY RATES TO 10 POUNDS 


3030 

IF W < 

= 1 THEN 

T = 2.24 


3040 

IF W > 

1 AND U 

<= 1.5 THEN 

T = 


2.30 


—rates in half-pound increments 

3050 

IF W > 

1.5 AND 

W <= 2 THEN 

T = 


2.54 




3 0 G 0 

IF N > 

2 AND M 

< = 2.5 THEN 

T = 


2.78 




3070 

IF W > 

2.5 AND 

M <= 3 THEN 

T = 


3.01 




3072 

IF W > 

3 AND M 

<= 3,5 THEN 

T = 


3.25 




3078 

IF W > 

3.5 AND 

W < = 4 THEN 

T = 


3.49 




3080 

IF M > 

4 AND W 

<= 4.5 THEN 

T = 


3.73 




3080 

IF W > 

4.5 AND 

W <= 5 THEN 

T = 


3.97 




3100 

IF U > 

5 AND W 

<= 6 THEN T 

= 4.44 




—rates by the pound now! 

3110 

IF W > 

6 AND W 

<= 7 THEN T 

= 4.82 

3120 

IF W ) 

7 AND W 

<= 8 THEN T 

= 5.39 

3130 

IF W > 

8 AND W 

<= 8 THEN T 

= 5.87 

3140 

IF W > 

9 THEN T 

' = 6,35 


3150 

GOTO 3! 

240 

—branch to R E T U R N statement 

3160 

REM 





PRIORITY RATES FOR ODER 10 
POUNDS 


3170 T1 = I NT (N / 5 - 1) * 2.38 + 

3.97 —first 5 pounds cost $3.97; each 

added 5 pounds cost $2.38 
3180 N1 = W - I NT <W / 5) * 5 

—how many odd pounds are 
there (pounds that are not 
multiples of 5 and must be 
charged at a special rate)? 
3180 IF W1 = 1 THEN T2 = .47 

3200 IF W1 = 2 THEN T2 = .85 
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3210 IF Ml = 3 THEN T2 - 1.42 
3220 IF Ml = 4 THEN T2 = 1.00 
3230 T = T1 + T2 —add the 5-pound-multiples rate 

to the odd-pounds rate 

3240 RETURN —endroutine 

10000 REM 

EXPRESS MAIL CONSISTENCY CHECK 

10010 DATA 9.35 * 9.35* 9.55* 9.90* 

10.30* 10.G5 * 11.00* 11.40* 

11.75* 0 —express mail rates; 0 at end is 

“last item” flag 


10020 

X = 

0 

—set up counter to check how 
many rates are read from 
DATA list 

10030 

X = 

X + 

1 —increment counter 

10040 

READ 

R ( 

X ) —put price into proper array 

element 

10050 

IF R 

(X) 

= 0 THEN 10070 

—price of 0 marks end of list 

100G0 

GOTO 

10030 —get next price 

10070 

X = 

X - 

1 —X includes count of “last item” 

flag from 10 0 5 0; subtract it 
from count since it’s a 
“dummy” item 

10080 

IF Ml$ = 

= "P" THEN 10100 

—next line is for ounces only 

10090 

M = 

M / 

1G —convert ounces to pounds 

10100 

IF N 

< = 

X THEN 10140 


—if weight in pounds is covered 
by the rate chart, then go 
ahead 


10110 PRINT 

10120 PRINT CHR$ (7)5 CHR$ (7)5 "TOO 
HEAMY FOR MY TABLES - PLEASE 
CALL THE POST OFFICE" 

—sorry; can’t help you 

10130 EFLAG = 1 —set flag indicating inconsistent 

weight/type; will be checked at 
line 720 

10140 RETURN —endroutine 

11000 REM 

FIRST CLASS CONSISTENCY CHECK 

11010 IF Ml$ = "0" AND M < 12.01 THEN 

110 B 0 —OK if not more than 12 ounces 
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11020 

11030 


11040 

11050 


HOBO 


12000 


12010 
1 2020 


12030 

12040 


12050 


1 2 0 G 0 


12070 

12080 

12090 


12100 

12110 


12120 

12130 


12150 


PRINT 

PRINT CHR$ (7)5 CHR$(7)5 "TOO 
HEAVY FOR FIRST CLASS" 


PRINT "TRY 

—sorry—i nconsistent! 
PRIORITY MAIL" 

EFLAG = 1 

—suggest alternative 
—set flag indicating inconsistent 

RETURN 

weight/type; will be checked at 
line 720 
—end routine 

REM 



PRIORITY MAIL CONSISTENCY CHECK 


IF Wl$ = "P" THEN 12030 

—if in pounds, then skip down 
IF W > 12 THEN 12080 

—skip down if weight is between 
12 and 16 ounces 


PRINT 

PRINT CHR$ (7)5 CHR$ (7)5 "TOO 
LIGHT FOR PRIORITY MAIL -" 


—too light! 

PRINT "TRY FIRST CLASS" 

—suggest alternative 

EFLAG = 1 —set flag indicating inconsistent 

weight/type; will be checked at 
line 720 

GOTO 12150 —branch to end of routine 

W = W / 16 —convert ounces to pounds 

IF M <= 70 THEN 12150 

—final check: is item on the 
charts? 

PRINT 

PRINT CHR$ (7)5 CHR$ (7)5 "TOO 
HEAVY FOR PRIORITY MAIL -" 

—off the charts 


PRINT "TRY ONE OF THE AIR EXPRESS 
COMPANIES" —too big for the Post Office! 

EFLAG = 1 —set flag indicating inconsistent 

weight/type; will be checked at 
line 720 

RETURN —end routine 
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59999 REM 


UTILITY ROUTINES 

—routines useful for various 
tasks but ancillary to rest of 
program 

BO000 REM 

K E Y S T A L L —routine to interrupt program 

until user presses a key 

B 0 010 M T A B 24 —move cursor to screen bottom 

B 0 0 2 0 IN M E R S E —set text to appear black-on- 

white 

BO030 PRINT "PRESS RETURN TO GO ON..."! 
60040 GET A$ —wait for keypress 

BO 050 NORMAL —restore ordinary white-on- 

black 

BOO BO RETURN —end routine 

B1000 REM 

MONEY FORMATTER 

—adds zeros after the decimal 
point where needed 

—turn the calculated postage 
fee into a string 
THEN T$ = T$ + 

—if charge is in whole dollars, 
add a decimal point and two 
zeros 

(T$ ,2) ) = 4B THEN 
—if second character from the 
right is a decimal point (ASCII 
code 4B) then number has 
only one digit to right of deci¬ 
mal—so add a “0” to the string 
—end the routine 


B1010 

T $ 

= STR$ ( 

T) 

B 1020 

IF 

T - 

INT 

(T) 



" ,00" 



B1 0 3 0 

IF 

ASC 

(RIGHT$ 



T $ = 

T $ + 

"0 


S1040 RETURN 
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Glossary 


Glossary of Technical Terms 


address: A number used to identify something, such as a location in 
the computer’s memory. 

algorithm: A step-by-step procedure for solving a problem or ac¬ 
complishing a task. 

A N D: A logical operator that produces a true result if both of its oper¬ 
ands are true, a false result if either or both of its operands are false; 
compare OR, NOT. 

Apple lie: A personal computer in the Apple II family, manufactured 
and sold by Apple Computer. 

Apple lie 80-Column Text Card: A peripheral card made and sold by 
Apple Computer that plugs into the Apple lie’s auxiliary slot and con¬ 
verts the computer’s display of text from 40- to 80-column width. 

Apple lie Extended 80-Column Text Card: A peripheral card made 
and sold by Apple Computer that plugs into the Apple lie’s auxiliary 
slot and converts the computer’s display of text from 40- to 80-column 
width while extending its memory capacity by 64K bytes. 

Applesoft: An extended version of the BASIC programming lan¬ 
guage used with the Apple lie computer and capable of processing 
numbers in floating-point form. An interpreter for creating and execut¬ 
ing programs in Applesoft is built into the Apple lie system in firm¬ 
ware. Compare Integer BASIC. 

application program: A program that puts the resources and capa¬ 
bilities of the computer to use for some specific purpose or task, such 
as word processing, data-base management, graphics, or telecom¬ 
munications. Compare system program. 
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application software: The component of a computer system con¬ 
sisting of application programs. 

argument: The value on which a function operates. 

arithmetic operator: An operator, such as +, that combines nu¬ 
meric values to produce a numeric result; compare relational opera¬ 
tor, logical operator. 

array: A collection of variables referred to by the same name and dis¬ 
tinguished by means of numerical subscripts. 

ASCII: American Standard Code for Information Interchange; a code 
in which the numbers from 0 to 12 7 stand for text characters, used 
for representing text inside a computer and for transmitting text be¬ 
tween computers or between a computer and a peripheral device. 

assembler: A language translator that converts a program written in 
assembly language into an equivalent program in machine language. 

assembly language: A low-level programming language in which in¬ 
dividual machine-language instructions are written in a symbolic 
form more easily understood by a human programmer than machine 
language itself. 

auxiliary slot: The special expansion slot inside the Apple lie used 
for the Apple 80-Column Text Card or Extended 80-Column Text 
Card. 

back panel: The rear face of the Apple lie computer, which includes 
the power switch, the power connector, and connectors for a video 
display device, a cassette tape recorder, and other peripheral 
devices. 

BASIC: Beginner’s All-purpose Symbolic Instruction Code; a high- 
level programming language designed to be easy to learn and use. 
Two versions of BASIC are available from Apple Computer for use 
with the Apple lie: Applesoft (built into the Apple lie in firmware) and 
Integer BASIC (provided on the DOS 3.3 SYSTEM MASTER disk). 

binary: The representation of numbers in terms of powers of two, us¬ 
ing the two digits 0 and 1. Commonly used in computers, since the 
values 0 and 1 can easily be represented in physical form in a vari¬ 
ety of ways, such as the presence or absence of current, positive or 
negative voltage, or a white or black dot on the display screen. 
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binary file: A file containing “raw” information not expressed in text 
form; compare text file. 

binary operator: An operator that combines two operands to pro¬ 
duce a result; for example, + is a binary arithmetic operator, < is a 
binary relational operator, and OR is a binary logical operator. Com¬ 
pare unary operator. 

bit: A binary digit (0 or 1); the smallest possible unit of information, 
consisting of a simple two-way choice, such as yes or no, on or off, 
positive or negative, something or nothing. 

bit bucket: The final resting place of all information; see write-only 
memory. 

body: The statements or instructions making up some construct in a 
program, such as a loop or a subroutine. 

boot: To start up a computer by loading a program into memory from 
an external storage medium such as a disk. Often accomplished by 
first loading a small program whose purpose is to read the larger pro¬ 
gram into memory. The program is said to “pull itself in by its own 
bootstraps”; hence the term bootstrapping or booting. 

boot disk: See startup disk. 

bootstrap: See boot. 

branch: To send program execution to a line or statement other than 
the next in sequence. 

buffer: An area of the computer’s memory reserved for a specific 
purpose, such as to hold graphical information to be displayed on the 
screen or text characters being read from some peripheral device. 
Often used as an intermediary “holding area” for transferring infor¬ 
mation between devices operating at different speeds, such as the 
computer’s processor and a printer or disk drive. Information can be 
stored into the buffer by one device and then read out by the other at 
a different speed. 

bug: An error in a program that causes it not to work as intended. 

byte: A unit of information consisting of a fixed number of bits; on the 
Apple He, one byte consists of eight bits and can hold any value from 
0 to 255. 
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call: To request the execution of a subroutine or function. 

card: See peripheral card. 

catalog: A list of all files stored on a disk; sometimes called a 
directory. 

cathode-ray tube: An electronic device, such as a television picture 
tube, that produces images on a screen coated with phosphors that 
emit light when struck by a focused beam of electrons. 

central processing unit: See processor. 

character: A letter, digit, punctuation mark, or other written symbol 
used in printing or displaying information in a form readable by 
humans. 

character code: A number used to represent a text character for 
processing by a computer system. 

code: (1) A number or symbol used to represent some piece of infor¬ 
mation in a compact or easily processed form. (2) The statements or 
instructions making up a program. 

command: A communication from the user to a computer system 
(usually typed from the keyboard) directing it to perform some imme¬ 
diate action. 

compiler: A language translator that converts a program written in a 
high-level programming language into an equivalent program in 
some lower-level language (such as machine language) for later exe¬ 
cution. Compare interpreter. 

component: A part; in particular, a part of a computer system. 

computer: An electronic device for performing predefined (pro¬ 
grammed) computations at high speed and with great accuracy. 

computer system: A computer and its associated hardware, firm¬ 
ware, and software. 

concatenate: Literally, “to chain together”; to combine two or more 
strings into a single, longer string containing all the characters in the 
original strings. 


312 


Glossary of Technical Terms 










conditional branch: A branch that depends on the truth of a condi¬ 
tion or the value of an expression; compare unconditional branch. 

constant: A symbol in a program representing a fixed, unchanging 
value; compare variable. 

control: The order in which the statements of a program are 
executed. 

control character: A character that controls or modifies the way in¬ 
formation is printed, transmitted or displayed. Control characters 
have ASCII codes between 0 and 31 and are typed from the Apple 
lie keyboard by holding down the | control | key while typing some 
other character. For example, the character 1 control | -C (ASCII 
code 3) means “interrupt program execution.” 

controller card: A peripheral card that connects a device such as a 
printer or disk drive to the Apple lie and controls the operation of the 
device. 

control variable: See index variable. 

CPU: Central processing unit; see processor. 

crash: To cease operating unexpectedly, possibly damaging or de¬ 
stroying information in the process. 

CRT: See cathode-ray tube. 

current input device: The source, such as the keyboard or a mo¬ 
dem, from which an Applesoft program is currently receiving its input. 

current output device: The destination, such as the display screen 
or a printer, to which an Applesoft program is currently sending its 
output. 

cursor: A marker or symbol displayed on the screen that marks 
where the user’s next action will take effect or where the next charac¬ 
ter typed from the keyboard will appear. 

data: Information; especially information used or operated on by a 
program. 

debug: To locate and correct an error or the cause of a problem or 
malfunction in a computer program. 
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decimal: The common form of number representation used in every¬ 
day life, in which numbers are expressed in terms of powers of ten, 
using the ten digits 0 to 9. 

default: (1) A value, action, or setting that is automatically used by a 
computer system when no other explicit information has been given. 
For example, if a command to run a program from a disk does not 
identify which disk drive to use, the Disk Operating System will auto¬ 
matically use the same drive that was used in the last operation. (2) 
That which, dear Brutus, is not in our stars. 

deferred execution: The saving of an Applesoft program line for ex¬ 
ecution at a later time as part of a complete program; occurs when 
the line is typed with a line number. Compare immediate execution. 

delimiter: A character that is used for punctuation to mark the begin¬ 
ning or end of a sequence of characters, and which therefore is not 
considered part of the sequence itself. For example, Applesoft uses 
the double quotation mark (") as a delimiter for string constants: the 
string " DOG" consists of the three characters D, 0, and G, and does 
not include the quotation marks. In written English, the space charac¬ 
ter is used as a delimiter between words. 

device: (1) A physical apparatus for performing a particular task or 
achieving a particular purpose. (2) In particular, a hardware compo¬ 
nent of a computer system. 

digit: (1) One of the characters 0 to 9, used to express numbers in 
decimal form. (2) One of the characters used to express numbers in 
some other form, such as 0 and 1 in binary or 0 to 9 and A to F in 
hexadecimal. 

dimension: The maximum size of one of the subscripts of an array. 

directory: A list of all files stored on a disk; sometimes called a 
catalog. 

disk: An information storage medium consisting of a flat, circular 
magnetic surface on which information can be recorded in the form of 
small magnetized spots, similarly to the way sounds are recorded on 
tape. 

disk drive: A peripheral device that writes and reads information on 
the surface of a magnetic disk. 
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diskette: A term sometimes used for the small (5-1/4-inch) flexible 
disks used with the Apple Disk II drive. 

Disk il drive: A model of disk drive made and sold by Apple Com¬ 
puter for use with the Apple lie computer; uses 5-1 /4-inch flexible 
(“floppy”) disks. 

Disk Operating System: An optional software system for the Apple 
lie that enables the computer to control and communicate with one or 
more Disk II drives. 

disk-resident: Stored or held permanently on a disk. 

display: (1) Information exhibited visually, especially on the screen 
of a display device. (2) To exhibit information visually. (3) A display 
device. 

display color: The color currently being used to draw high- or low- 
resolution graphics on the display screen. 

display device: A device that exhibits information visually, such as a 
television receiver or video monitor. 

display screen: The glass or plastic panel on the front of a display 
device, on which images are displayed. 

DOS: See Disk Operating System. 

edit: To change or modify; for example, to insert, remove, replace, or 
move text in a document. 

element: A member of a set or collection; specifically, one of the indi¬ 
vidual variables making up an array. 

embedded: Contained within. For example, the string 
"HUMPTY DUMPTY" is said to contain an embedded space. 

ending value: The value against which the index variable is tested 
after each pass through a loop, to determine when to stop repeating 
the loop. 

error code: A number or other symbol representing a type of error. 

error message: A message displayed or printed to notify the user of 
an error or problem in the execution of a program. 
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escape mode: A state of the Apple lie computer, entered by pressing 
the 1 esc | key, in which certain keys on the keyboard take on special 
meanings for positioning the cursor and controlling the display of text 
on the screen. 

escape sequence: A sequence of keystrokes beginning with the 
| esc | key, used for positioning the cursor and controlling the display 
of text on the screen. 

execute: To perform or carry out a specified action or sequence of 
actions, such as those described by a program. 

expansion slot: A connector inside the Apple lie computer in which 
a peripheral card can be installed; sometimes called peripheral slot. 

expression: A formula in a program describing a calculation to be 
performed. 

FIFO: First in, first out. 

file: A collection of information stored as a named unit on a periph¬ 
eral storage medium such as a disk. 

file name: The name under which a file is stored. 

firmware: Those components of a computer system consisting of 
programs stored permanently in read-only memory. Such programs 
(for example, the Applesoft interpreter and the Apple lie Monitor pro¬ 
gram) are built into the computer at the factory; they can be executed 
at any time but cannot be modified or erased from main memory. 
Compare hardware, software. 

fixed-point: A method of representing numbers inside the computer 
in which the decimal point (more correctly, the binary point) is consid¬ 
ered to occur at a fixed position within the number. Typically, the point 
is considered to lie at the right end of the number, so that the number 
is interpreted as an integer. Fixed-point numbers of a given length 
cover a narrower range than floating-point numbers of the same 
length, but with greater precision. Compare floating-point. 

flag: A variable whose contents (usually 1 or 0, standing for true or 
false) indicate whether some condition holds or whether some event 
has occurred, used to control the program’s actions at some later 
time. 
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floating-point: A method of representing numbers inside the com¬ 
puter in which the decimal point (more correctly, the binary point) is 
permitted to “float” to different positions within the number. Some of 
the bits within the number itself are used to keep track of the point’s 
position. Floating-point numbers of a given length cover a wider 
range than fixed-point numbers of the same length, but with less pre¬ 
cision. Compare fixed-point. 

format: (1) The form in which information is organized or presented. 
(2) To specify or control the format of information. (3) To prepare a 
blank disk to receive information by dividing its surface into tracks 
and sectors; also initialize. 

function: A preprogrammed calculation that can be carried out on 
request from any point in a program. 

GAME I/O connector: A special 16-pin connector inside the Apple 
lie, originally designed for connecting hand controls to the computer, 
but also used for connecting some other peripheral devices. Com¬ 
pare hand control connector. 

graphics: (1) Information presented in the form of pictures or im¬ 
ages. (2) The display of pictures or images on a computer’s display 
screen. Compare text. 

hand control: An optional peripheral device that can be connected 
to the Apple lie’s hand control connector and has a rotating dial and a 
pushbutton; typically used to control game-playing programs, but can 
be used in more serious applications as well. 

hand control connector: A 9-pin connector on the Apple lie’s back 
panel, used for connecting hand controls to the computer. Compare 

GAME I/O connector. 

hang: For a program or system to “spin its wheels” indefinitely, per¬ 
forming no useful work. 

hard copy: Information printed on paper for human use. 

hardware: Those components of a computer system consisting of 
physical (electronic or mechanical) devices. Compare software, 
firmware. 
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hertz: The unit of frequency of vibration or oscillation, also called 
cycles per second; named for the physicist Heinrich Hertz and abbre¬ 
viated Hz. The current provided by a standard power outlet alternates 
at a rate of 60 hertz; that is, it changes polarity 60 times each second. 
The Apple lie’s 6502 microprocessor operates at a clock frequency of 
1 million hertz, or 1 megahertz (MHz). 

hexadecimal: The representation of numbers in terms of powers of 
sixteen, using the sixteen digits 0 to 9 and A to F. Hexadecimal num¬ 
bers are easier for humans to read and understand than binary num¬ 
bers, but can be converted easily and directly to binary form: each 
hexadecimal digit corresponds to a sequence of four binary digits, or 
bits. 

high-level language: A programming language that is relatively 
easy for humans to understand. A single statement in a high-level 
language typically corresponds to several instructions of machine 
language. 

high-order byte: The more significant half of a memory address or 
other two-byte quantity. In the Apple lie’s 6502 microprocessor, the 
low-order byte of an address is usually stored first and the high-order 
byte second. 

high-resolution graphics: The display of graphics on the Apple lie’s 
display screen as a six-color array of points, 280 columns wide and 
192 rows high. 

Hz: See hertz. 

immediate execution: The execution of an Applesoft program line 
as soon as it is typed; occurs when the line is typed without a line 
number. Compare deferred execution. 

implement: To realize or bring about; for example, a language trans¬ 
lator implements a particular language. 

infinite loop: A section of a program that will repeat the same se¬ 
quence of actions indefinitely. 

information: Facts, concepts, or instructions represented in an or¬ 
ganized form. 

index: (1) A number used to identify a member of a list or table by its 
sequential position. (2) A list or table whose entries are identified by 
sequential position. 
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index variable: A variable whose value changes on each pass 
through a loop; often called control variable or loop variable. 

initialize: (1) To set to an initial state or value in preparation for some 
computation. (2) To prepare a blank disk to receive information by di¬ 
viding its surface into tracks and sectors; also format. 

input: (1) Information transferred into a computer from some exter¬ 
nal source, such as the keyboard, a disk drive, or a modem. (2) The 
act or process of transferring such information. 

instruction: A unit of a machine-language or assembly-language 
program corresponding to a single action for the computer’s proces¬ 
sor to perform. 

integer: A whole number, with no fractional part; represented inside 
the computer in fixed-point form. Compare real number. 

Integer BASIC: A version of the BASIC programming language used 
with the Apple II family of computers; older than Applesoft and capa¬ 
ble of processing numbers in integer (fixed-point) form only. An inter¬ 
preter for creating and executing programs in Integer BASIC is 
included on the DOS 3.3 SYSTEM MASTER disk, and is automati¬ 
cally loaded into the computer’s memory when the computer is 
started up with that disk. Compare Applesoft. 

interactive: Operating by means of a dialog between the computer 
system and a human user. 

interface: The devices, rules, or conventions by which one compo¬ 
nent of a system communicates with another. 

interpreter: A language translator that reads a program written in a 
particular programming language and immediately carries out the ac¬ 
tions that the program describes. Compare compiler. 

inverse video: The display of text on the computer’s display screen 
in the form of black dots on a white (or other single phosphor color) 
background, instead of the usual white dots on a black background. 

I/O: Input/output; the transfer of information into and out of a com¬ 
puter. See input, output. 

I/O device: Input/output device; a device that transfers information 
into or out of a computer. See input, output, peripheral device. 
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K: Two to the tenth power, or 1024 (from the Greek root kilo, meaning 
one thousand); for example, 64K equals 64 times 1024, or 65,536. 

keyboard: The set of keys built into the Apple lie computer, similar to 
a typewriter keyboard, for typing information to the computer. 

keystroke: The act of pressing a single key or a combination of keys 
(such as | control | -C) on the Apple lie keyboard. 

keyword: A special word or sequence of characters that identifies a 
particular type of statement or command, such as RUN or PRINT. 

kilobyte: A unit of information consisting of 1K (1024) bytes, or 8K 
(8192) bits; see K. 

language: See programming language. 

language translator: A system program that reads a program writ¬ 
ten in a particular programming language and either executes it di¬ 
rectly or converts it into some other language (such as machine 
language) for later execution. See interpreter, compiler, assembler. 

LIFO: Last in, first out. 

line: See program line. 

line number: A number identifying a program line in an Applesoft 
program. 

load: To transfer information from a peripheral storage medium (such 
as a disk) into main memory for use; for example, to transfer a pro¬ 
gram into memory for execution. 

location: See memory location. 

logical operator: An operator, such as AND, that combines logical 
values to produce a logical result; compare arithmetic operator, rel¬ 
ational operator. 

loop: A section of a program that is executed repeatedly, usually until 
some condition is met (such as an index variable reaching a specified 
ending value). 

loop variable: See index variable. 
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low-level language: A programming language that is relatively close 
to the form that the computer’s processor can execute directly. 

low-order byte: The less significant half of a memory address or 
other two-byte quantity. In the Apple lie’s 6502 microprocessor, the 
low-order byte of an address is usually stored first and the high-order 
byte second. 

low-resolution graphics: The display of graphics on the Apple lie’s 
display screen as a sixteen-color array of blocks, 40 columns wide 
and 48 rows high. 

machine language: The form in which instructions to a computer are 
stored in memory for direct execution by the computer’s processor. 
Each model of computer processor (such as the 6502 microproces¬ 
sor used in the Apple lie) has its own form of machine language. 

main memory: The memory component of a computer system that 
is built into the computer itself and whose contents are directly ac¬ 
cessible to the processor. 

mask: A pattern of bits for use in bit-level logical operations. 

memory: A hardware component of a computer system that can 
store information for later retrieval; see main memory, random-ac¬ 
cess memory, read-only memory, read-write memory, write-only 
memory. 

memory location: A unit of main memory that is identified by an ad¬ 
dress and can hold a single item of information of a fixed size; in the 
Apple lie, a memory location holds one byte, or eight bits, of 
information. 

memory-resident: (1) Stored permanently in main memory, as firm¬ 
ware. (2) Held continually in main memory even while not in use, as 
the Disk Operating System. 

menu : A list of choices presented by a program, usually on the dis¬ 
play screen, from which the user can select. 

MHz: Megahertz; one million hertz. See hertz. 

microcomputer: A computer, such as the Apple lie, whose proces¬ 
sor is a microprocessor. 
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microprocessor: A computer processor contained in a single inte¬ 
grated circuit, such as the 6502 microprocessor used in the Apple lie. 

mode: A state of a computer or system that determines its behavior. 

modem: Modulator/demodulator; a peripheral device that enables 
the computer to transmit and receive information over a telephone 
line. 

monitor: See video monitor. 

Monitor program: A system program built into the Apple lie in firm¬ 
ware, used for directly inspecting or changing the contents of main 
memory and for operating the computer at the machine-language 
level. 

nested loop: A loop contained within the body of another loop and 
executed repeatedly during each pass through the containing loop. 

nested subroutine call: A call to a subroutine from within the body 
of another subroutine. 

nibble: A unit of information equal to half a byte, four bits, or fifty 
cents; can hold any value from 0 to 15. Sometimes spelled nybble. 

N 0 T: A unary logical operator that produces a true result if its oper¬ 
and is false, a false result if its operand is true; compare AND, OR. 

null string: A string containing no characters. 

operand: A value to which an operator is applied. 

operating system: A software system that organizes the computer’s 
resources and capabilities and makes them available to the user or to 
application programs running on the computer. 

operator: A symbol or sequence of characters, such as 4- or AND, 
specifying an operation to be performed on one or more values (the 
operands) to produce a result; see arithmetic operator, relational 
operator, logical operator, unary operator, binary operator. 

0 R: A logical operator that produces a true result if either or both of 
its operands are true, a false result if both of its operands are false; 
compare AND, NOT. 
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output: (1) Information transferred from a computer to some external 
destination, such as the display screen, a disk drive, a printer, or a 
modem. (2) The act or process of transferring such information. 

page: (1) A screenful of information on a video display, consisting on 
the Apple lie of 24 lines of 40 or 80 characters each. (2) An area of 
main memory containing text or graphical information being dis¬ 
played on the screen. (3) A segment of main memory 256 bytes long 
and beginning at an address that is an even multiple of 256 bytes. 

pass: A single execution of a loop. 

peek: To read information directly from a location in the computer’s 
memory. 

peripheral: At or outside the boundaries of the computer itself, either 
physically (as a peripheral device) or in a logical sense (as a periph¬ 
eral card). 

peripheral card: A removable printed-circuit board that plugs into 
one of the Apple lie’s expansion slots and expands or modifies the 
computer’s capabilities by connecting a peripheral device or per¬ 
forming some subsidiary or peripheral function. 

peripheral device: A device, such as a video monitor, disk drive, 
printer, or modem, used in conjunction with a computer. Often (but 
not necessarily) physically separate from the computer and con¬ 
nected to it by wires, cables, or some other form of interface, typically 
by means of a peripheral card. 

peripheral slot: See expansion slot. 

plotting vector: A code in a shape definition representing a single 
step in drawing a shape on the high-resolution graphics screen, 
specifying whether to plot a point at the current screen position and in 
what direction to move (up, down, left, or right) before processing the 
next vector. See shape definition, shape table. 

point of call: The point in a program from which a subroutine or func¬ 
tion is called. 

pointer: An item of information consisting of the memory address of 
some other item. For example, Applesoft maintains internal pointers 
to (among other things) the most recently stored variable, the most 
recently typed program line, and the most recently read DATA item. 
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poke: To store information directly into a location in the computer’s 
memory. 

pop: To remove the top entry from a stack. 

precedence: The order in which operators are applied in evaluating 
an expression. 

printed-circuit board: A hardware component of a computer or 
other electronic device, consisting of a flat, rectangular piece of rigid 
material, commonly fiberglass, to which integrated circuits and other 
electronic components are connected. 

printer: A peripheral device that writes information on paper in a 
form easily readable by humans or literate androids. 

processor: The hardware component of a computer that performs 
the actual computation by directly executing instructions represented 
in machine language and stored in main memory. 

program: (1) A set of instructions describing actions for a computer 
to perform in order to accomplish some task, conforming to the rules 
and conventions of a particular programming language. In Applesoft, 
a sequence of program lines, each with a different line number. (2) To 
write a program. 

program line: The basic unit of an Applesoft program, consisting of 
one or more statements separated by colons (:). 

programmer: The human author of a program; one who writes 
programs. 

programming: The activity of writing programs. 

programming language: A set of rules or conventions for writing 
programs. 

prompt: To remind or signal the user that some action is expected, 
typically by displaying a distinctive symbol, a reminder message, or a 
menu of choices on the display screen. 
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prompt character: (1) A text character displayed on the screen to 
prompt the user for some action. Often also identifies the program or 
component of the system that is doing the prompting; for example, 
the prompt character ] is used by the Applesoft BASIC interpreter, > 
by Integer BASIC, and * by the system Monitor program. Also called 
prompting character. (2) Someone who is always on time. 

prompt message: A message displayed on the screen to prompt the 
user for some action. Also called prompting message. 

push: To add an entry to the top of a stack. 

queue: A list in which entries are added at one end and removed at 
the other, causing entries to be removed in FIFO (first-in-first-out) or¬ 
der; compare stack. 

RAM: See random-access memory. 

random-access memory: Memory in which the contents of individ¬ 
ual locations can be referred to in an arbitrary or random order. This 
term is often used incorrectly to refer exclusively to read-write mem¬ 
ory; but strictly speaking both read-only and read-write memory can 
be accessed in random order. This misuse of the term random- 
access is an attempt to confuse new users, creating a rite of passage 
and an excellent market for glossaries of computer terms. Compare 
read-only memory, read-write memory, write-only memory. 

read: To transfer information into the computer’s memory from a 
source external to the computer (such as a disk drive or modem) or 
into the computer’s processor from a source external to the proces¬ 
sor (such as the keyboard or main memory). 

read-only memory: Memory whose contents can be read but not 
written; used for storing firmware. Information is written into read¬ 
only memory once, during manufacture; it then remains there perma¬ 
nently, even when the computer’s power is turned off, and can never 
be erased or changed. Compare read-write memory, random-ac¬ 
cess memory, write-only memory. 

read-write memory: Memory whose contents can be both read and 
written; often misleadingly called random-access memory, or RAM. 
The information contained in read-write memory is erased when the 
computer’s power is turned off, and is permanently lost unless it has 
been saved on a more permanent storage medium, such as a disk. 
Compare read-only memory, random-access memory, write-only 
memory. 
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real number: A number that may include a fractional part; repre¬ 
sented inside the computer in floating-point form. Compare integer. 

relational operator: An operator, such as >, that compares numeric 
values to produce a logical result; compare arithmetic operator, 
logical operator. 

reserved word: A word or sequence of characters reserved by a 
programming language for some special use, and therefore unavail¬ 
able as a variable name in a program. 

resident: See memory-resident, disk-resident. 

return address: The point in a program to which control returns on 
completion of a subroutine or function. 

ROM: See read-only memory. 

routine: A part of a program that accomplishes some task subordi¬ 
nate to the overall task of the program. 

run: (1) To execute a program. (2) To load a program into main mem¬ 
ory from a peripheral storage medium, such as a disk, and execute it. 

save: To transfer information from main memory to a peripheral stor¬ 
age medium for later use. 

scientific notation: A method of expressing numbers in terms of 
powers of ten, useful for expressing numbers that may vary over a 
wide range, from very small to very large. For example, the number of 
atoms in a gram of hydrogen is approximately 6.0 2 E 2 3, meaning 
6.02 times ten to the 23rd power. (The letter E stands for “exponent.”) 
The number is easier to understand in this form than in the form 
6020000 000 0 0 0 0 0 0 0 0 0 0 0 0 0 0 . 

screen: See display screen. 

scroll : To change the contents of all or part of the display screen by 
shifting information out at one end (most often the top) to make room 
for new information appearing at the other end (most often the bot¬ 
tom), producing an effect like that of moving a scroll of paper past a 
fixed viewing window. See viewport, window. 

seed: A value used to begin a repeatable sequence of random 
numbers. 
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shape definition: A coded description of a shape to be drawn on the 
high-resolution graphics screen, consisting of one or more plotting 
vectors. See shape table, plotting vector. 

shape table: A collection of one or more shape definitions, together 
with their indices. 

shape table index: A list giving the memory addresses of the 
shapes in a shape table. 

simple variable: A variable that is not an element of an array. 

soft switch: A means of changing some feature of the Apple lie from 
within a program; specifically, a location in memory that produces 
some special effect whenever its contents are read or written. 

software: Those components of a computer system consisting of 
programs that determine or control the behavior of the computer. 
Compare hardware, firmware. 

space character: A text character whose printed representation is a 
blank space, typed from the keyboard by pressing the [ space | bar. 

stack: A list in which entries are added or removed at one end only 
(the top of the stack), causing them to be removed in LIFO (last-in- 
first-out) order; compare queue. 

starting value: The value assigned to the index variable on the first 
pass through a loop. 

startup disk: A disk containing software recorded in the proper form 
to be loaded into the Apple lie’s memory in order to set the system 
into operation. Sometimes called a boot disk; see boot. 

statement: A unit of a program in a high-level language specifying an 
action for the computer to perform, typically corresponding to several 
instructions of machine language. 

step value: The amount by which the index variable changes on 
each pass through a loop. 

stepwise refinement: A technique of program development in which 
broad sections of the program are laid out first, then elaborated step 
by step until a complete program is obtained. 

string: An item of information consisting of a sequence of text 
characters. 
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strobe: (1) An event, such as a change in a signal, that triggers some 
action. (2) A signal whose change is used to trigger some action. 

subroutine: A part of a program that can be executed on request 
from any point in the program, and which returns control to the point 
of the request on completion. 

subscript: An index number used to identify a particular element of 
an array. 

substring: A string that is part of another string. 

syntax: The rules governing the structure of statements or instruc¬ 
tions in a programming language. 

system: A coordinated collection of interrelated and interacting parts 
organized to perform some function or achieve some purpose. 

system program: A program that makes the resources and capabili¬ 
ties of the computer available for general purposes, such as an oper¬ 
ating system or a language translator. Compare application 
program. 

text: (1) Information presented in the form of characters readable by 
humans. (2) The display of characters on the Apple lie’s display 
screen. Compare graphics. 

text file: A file containing information expressed in text form; com¬ 
pare binary file. 

text window: An area on the Apple lie’s display screen within which 
text is displayed and scrolled. 

truncate: To shorten by discarding a part; specifically, to convert a 
real number to the next lower integer. 

unary operator: An operator that applies to a single operand; for ex¬ 
ample, the minus sign (-) in a negative number such as - B is a un¬ 
ary arithmetic operator. Compare binary operator. 

unconditional branch: A branch that does not depend on the truth 
of any condition; compare conditional branch. 

user: The person operating or controlling a computer system. 

user interface: The rules and conventions by which a computer sys¬ 
tem communicates with the person operating it. 
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value: An item of information that can be stored in a variable, such as 
a number or a string. 

variable: (1) A location in the computer’s memory where a value can 
be stored. (2) The symbol used in a program to represent such a lo¬ 
cation; compare constant. 

video: (1) A medium for transmitting information in the form of im¬ 
ages to be displayed on the screen of a cathode-ray tube. (2) Infor¬ 
mation organized or transmitted in video form. (3) An early space 
pioneer. 

video monitor: A display device capable of receiving video signals 
by direct connection only, and which cannot receive broadcast sig¬ 
nals such as commercial television. Most video monitors can be con¬ 
nected directly to the Apple lie computer as a display device. 

viewport: All or part of the display screen, used by an application 
program to display a portion of the information (such as a document, 
picture, or worksheet) that the program is working on. Compare 

window. 

window: (1) The portion of a collection of information (such as a doc¬ 
ument, picture, or worksheet) that is visible in a viewport on the dis¬ 
play screen; compare viewport. (2) A viewport. (3) A flat, rectangular 
panel, usually made of silica, used in many archaic structures as a 
human-to-nature interface. 

wraparound: The automatic continuation of text from the end of one 
line to the beginning of the next, as on the display screen or a printer. 

write: To transfer information from the computer to a destination ex¬ 
ternal to the computer (such as a disk drive, printer, or modem) or 
from the computer’s processor to a destination external to the pro¬ 
cessor (such as main memory). 

write-only memory: A form of computer memory into which informa¬ 
tion can be stored but never, ever retrieved, developed under govern¬ 
ment contract in 1975 by Professor Homberg T. Farnsfarfle. 
Farnsfarfle’s original prototype, approximately one inch on each side, 
has so far been used to store more than 100 trillion words of surplus 
federal information. Farnsfarfle’s critics have denounced his project 
as a six-million-dollar boondoggle, but his defenders point out that 
this excess information would have cost more than 250 billion dollars 
to store in conventional media. Compare read-only memory, read- 
write memory, random-access memory. 
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A 

ABS function 38,215 
absolute value 38,215 
addition 32,36,86 
American National Standards 
Institute (ANSI) 3 
American Standard Code for 
Information Interchange, see 
ASCII 

ampersand character (&=) 246 
AND 35,175 
animation 150 
annunciators 131,262,263 
ANSI: see American National 
Standards Institute 
Apple lie 80-Column Text Card, see 
80-Column Text Card 
arctangent 41,216 
argument of functions 37,38,125, 
173,179 

argument variable 44 
arithmetic functions 38 
arithmetic operators 31 
array(s) 26,29, 77ff, 217,228,248, 
249, 268, 275ff, 293ff, 298 
dimensions 79,80 
elements 29, 77,269 
names 29, 77 
storage 179 
variables 275ff 
arrow keys 18,20 
ASC function 215 
ASCII (American Standard Code for 
Information Interchange) 19,82, 
215, 241 ff, 258 

assignment statement 30,215, 
224, 251,296 
asterisk (*) 32 
ATN function 41,216 
auto-repeat 19,20 


e 

backslash character (\) 4,18 
BAD SUBSCRIPT error 79,248 
bell character ( I control! - G) 130 
B L 0 A D command 158 
body of loop 55 
booting 96,112 
branch 49ff,220 
conditional 51 
unconditional 50,220 
built-in arithmetic functions 38ff 

c 

CALL statement 71,136,216,249, 
253ff, 281,294 

CAN'T CONTINUEerror 248 

Icaps lock 1 key 4 

caret (-) 31 

cassette input 110 

cassette output 131,264 

Celsius 44 

character codes 82 

CHR$ function 91,216 

CLEAR command 9,30,129,216, 

294 

colon (:) 5,98ff, 105,106,177,192, 
246, 267, 296, 301 
color, see display color 
COLOR = statement 137,216 
comma (0 98ff, 105,113,114,115 
commands, see names of 
commands 

concatenation 83,84,100,251, 

295 

conditional branch 51 
constants 268 

C0NT command 16,17,73,216, 
247,248 

control characters 100,101,241 
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[CONTROL I key 15,16,18,241 
-8 98,107 
-B 176,177,181 
-C 15ff, 50, 58, 69, 72, 
98,107,159,180,216 
-G 130 
-H 100,107 
- J (line feed character) 
192,193,216,301 
-M 100,107 
- 1RESET1 13-17,96,112, 
161,162,166,171 
-S 15 

-X 18,100,107 

control 

stack 10,62ff, 71,227, 265 
statements 49ff 
COS function 40,217 
cosine 40,217 
crossed loops 60 
current input device 104,223 
current output device 10,113,224, 
228 

cursor 4,18ff, 97,113,115,119ff, 
220ff, 232, 234, 253, 254 
cursor control 287-288 

D 

DATA statement 103,105,108, 
217,228, 229,250 
debugging 11,180 
DEF FN statement 44,177,217, 
249 

deferred execution 4,5,9,247 
degrees 44 
DEL command 6,7,217 
1 DELETE 1 key 7 
DIM statement 79,217,251,293, 
295 298 

disk 12ff, 112,156,230 
Disk Operating System (DOS) 12, 
14,16,105,157,176,265, 298 
display color 137ff, 160,216,220ff, 
231 

display screen 111 
division 32 

D IMIS ION BY ZERO error 248 
dollar sign ($) 26,29,82,88,251, 
259 

DOS (see Disk Operating System) 
double quotation marks ( 11 ) 28,81, 
99,102,270 

I DOWN-ARRllWl key 18,19, 241 
DRAW statement 151,155,156, 
160,161,162,163,164,218,230, 
231 


£ 

e 42 

editing 287-288 
Eighty-Column Text Card 4,112, 
114,115,119,124,125,127,222, 
254, 287ff 

END statement 17,73,216,218, 
251,269,294 

equal sign (=) 30,34,44,129,137, 
145,163, 246 
equal to (=) 34 
error 

codes 68,69, 247ff 
messages 247ff 
error handling routines 67ff, 229, 
247,264 

restoring normal 71 
escape mode 19,287 
r~ESC~l key 20,242 
20,255 
-A 20 
-B 20 
-C 20 
-D 20 
-E 20 
-F 20,255 
-I 19,20 
-J 19,20 
-K 19,20 
-M 19,20 
exclusive-or 175 
execution of program 16 
EXP function 42,218 
expansion slot 96,111 
exponential 42,218 
exponentiation 32 
expressions 31 ff 
EXTRA IGNORED message 99, 
105 

F 

Fahrenheit 44 
false 33ff 

FILE NOT FOUNDerror 14 
FLASH statement 127,128,218, 
226 

floating-point accumulator 173 
FN keyword 45,219 
FOR statement 55ff, 219,225,271 
FORMULA TOO COMPLEX error 
248 

FP command 291 
fractions 33 
FRE function 178,220 
free space 275 
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full-screen graphics 136,138,143, 
144,146, 221,260 
function names 44 
functions 37ff, 173,177,229 
argument of 37,38,125,173,179 
built-in arithmetic 38 
call 37,38,45 
names 44 

user-defined 44-45,217 
ABS 38,215 
ASC 215 
ATN 41,216 
CHR$ 216 
COS 40,217 
EXP 42,218 
FRE 178,219 
I NT 39,223 
LEFT* 100,223,249 
LEN 224 
LET 215 
LOG 42,224,249 
MID* 100,225,249 
PEEK 130,131,177,178,180, 
247, 249, 253ff 
PDL 109,227 
P0S 125,228 
RIGHT* 100,229,249 
RND 43,229 
SCRN 141,231 
SGN 39,231 
SIN 40,231 

SPC 113,120-121,231,249 
SQR 40,232,249 
STR* 232 

TAB 113,120,121,123,126, 
181,232,233,249,254 
TAN 4,233 
USR 172,233 
UAL 102,105,233 

G 

GAME I/O connector 109 
GET statement 16,19,104,220, 
249 

G 0 S U B statement 61 ff, 220,227, 
229, 251,293 

GOTO statement 50,53,64,71, 
220,251,265,293 
G R statement 136,140,220,258, 
259,261 

graphics 119,135ff, 258 

greater than (>) 34 

greater than or equal to (> = or = >) 

34 

ground loop 297 


H 

hand control 109,262 
hand control connector 109,131, 
262,263 

HC0L0R= statement 145,160,220 
HGR statement 143,145,149,161, 
162, 220,258,259 
HGR2 statement 144,145,149, 
161,162,221,259 
high-resolution graphics 136,140ff, 
150,176ff, 218, 220ff, 230, 261 
HIM E M : statement 149,156,165, 
176,179,221,250,275, 299 
HLIN statement 139,221 
HOME statement 221,254 
HPLOT statement 146,161,218, 
222, 262 

HTAB statement 120,122,126, 
181,222,254,256 
HumptyDumpty 19 

/ 

IF ... THEN statement 33,36,52, 
222, 248, 251,267, 294 
ILLEGAL DIRECT error 249 
ILLEGAL QUANT I TV error 40, 
42,52, 66, 86ff, 92,97,109,112, 
121ff 129,138ff, 146,147,161ff, 
170,171,175ff, 249 
immediate execution 4,7,9,257 
IN#statement 96,223 
index variable 55ff, 219,225,271 
infinite loop 58 
input 95,223 
numeric 100 

Input Anything Routine 102 
INPUT statement 16,17,97, 

102, 223,249,294 
input/output 93ff 
string 99 

I NT function 39,223,291 
integer 

constants 270 
part 39,223 

variables 26,27,44,58,270, 
275ff 

Integer BASIC 260,291 
INVERSE statement 126,128, 
223,226 

j 

J M P (Jump) instruction 173,233 
JSR (Jump to Subroutine) 
instruction 173,174,246 
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K 

keyboard 96,258 
keyword tokens 280ff 
keywords 4 

L 

LEFT$ function 86,100,223,249 
I LEFT-ARROW 1 key 18,19,100, 

241 

LEN function 83,85,224 
LET statement 215,224 
less than (<) 34 

less than or equal to (< = or = <) 34 
line feed character ( I control I - J) 
192,193,216,255 
line numbers 5ff, 50,51,64,65,70, 
180, 220, 226,232,233, 251,265, 
267, 293, 294 

LI ST Command 7,10,224 
LOAD Command 14,110,224,298 
LOG function 42,224,249 
logarithm, natural 42,224 
logical operators 35,54 
logical values 33,36,54 
L 0 M E M: statement 177,225,250 
loops 10, 55ff, 219, 225,250, 270, 
296 

body 55 
crossed 60 
nested 59 

low-resolution graphics 135,216, 
220, 221,231,234, 258,261 

M 

machine language 172,176,177, 
179,216,221,233,246 
mask 174 
MAT functions 296 
memory allocation 25,275 
memory management 176 
MI D$ function 87,100,225,249 
minus sign (-) 36,105 
mixed graphics and text 119,136, 
138,140,141,143,146, 220,260 
Monitor program 16,72,155ff, 172, 
173,176,177,181 
multidimensional array 80 
multiple input 98 
multiple statements per line 5 
multiplication 32 

N 

natural logarithm 42,224 
nested loops 59 


nested subroutines 62 
NEW command 9,30,150,177,225 
NEXT statement 55ff, 225,271, 
294 

NEXT WITHOUT FOR error 10, 
60,249 

NORMAL statement 126,128,226 
NOT 35,54 

not equal to (<> or X) 34 
N0TRACE command 181,226 
null character ( I CONTROL l -@) 98, 
100,101,105 

null string 9,12,28,30,81,82,88, 
97,98,100,106,251,294 
number formats 117 
number sign (#) 96,111,180,246 
numeric constants 117,283 
numeric input 100 

o 

ON. . . G0SUB statement 65,226, 
249 

0 N, . . G 0 T 0 statement 51,226, 
249 

on-screen edit 17 
0NERR GOTO Statement 68,72, 
226,229, 247, 239,264,265 
I open-apple I key 110,262 
operators 3Iff 
arithmetic 30 
logical 35,54 
precedence of 36 
relational 33,54 
OR 34,54 

OUT OF DATA error 106,250 
OUT OF MEMORY error 60,64, 
177,178,250,299 
output 111 

OMERFLOW error 90,91,250 

P 

parentheses 37,250,276 
PDL function 109,227 
PEEK function 68,70,110,130, 

131,170,177,178,180, 227,247, 
249,253ff, 294 
percent character (%) 26,28 
period (.) 105 
PLOT statement 138,227 
plotting vector 150ff 
plus sign ( + ) 36,84,105,295 
point of call 61,64 
pointer 275 
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POKE statement 71,72,129ff, 136, 
143,149,155,156,159,170ff, 

227, 249, 253ff, 294 
POP statement 66,227 
POS function 125,228 
pound sign (#) 96 
PR# statement 10,111,228 
precedence 36 

PR I NT statement 105,113ff, 120, 
121,223, 226,228, 231,232,254, 
267 

TAB used in 121ff 
printer 10,111 
program 275 
execution 16 
layout 189 
lines 3 
planning 185 
specification 185 
prompt character (!) 4,16,119, 
247 

prompting message 97,294 
pure cursor moves 19 

Q 

question mark (?) 97,116,294 

R 

radians 40,41,44 
RAM (random-access memory) 
176,179 

random numbers 43,229 
READ statement 105,108,207, 
217,129,250 

real variables 25,27,44,58,270, 
275-277 

RECALL statement 110,298 
REDIM'D ARRAY error 79,250 
REENTER message 99,100 
relational operators 33,54,82 
REM statement 7,229,267 
reserved words 27,245-246,276 
I reset I key 16 
reset vector 16 

restarting the system 96,112,176, 
181 

RESTORE statement 106,108, 
229, 250 

Restoring Normal Error Handling 
71 

RESUME statement 69,70,229, 
249, 265 

return address 63,66,227 


I return i key 4,6,10,13,16,18, 
100,104,158,165, 219, 241,293 
INPUT statement use 97,98 
RETURN statement 61 ff, 220,227, 
251 

RETURN WITHOUT G0SUB error 64, 
67, 251 

right bracket (]) 4,16,119,247 
RI GHT\ function 100,229,249 
1 RIGHT-ARROW I key 18,19,241 
RND function 43,229 
R0T= statement 160,164,230 
rotation 230 
rounding 39 

RTS (Return From Subroutine) 174 
RUN Command 12,14,30,108, 
145,150,230,294 

s 

SAME Command 13,131,230,297 
scale factor 230 

SCALE = statement 160,163,164, 
230 

scientific notation 43,91,118, 283 
SC RN function 141,231 
scrolling 253 
seeding 43 

semicolon (;) 113ff, 122,267,269 
SGN function 39,231 
shape definition 150 
shape table(s) 150ff, 230,231,234, 
299 

index 153 
loading 154ff 

SHL0 AD statement 110,156,158, 
165,231,299 
sign of a number 39,231 
simple variables 275-277 
SIN function 40,231 
sine 40, 231 
slash (/) 296 
soft switches 253,259 
1 SOLID-APPLE 1 key 110,262 
spacebar 19,21 
space character 99,101,105,231 
SPC function 113,120-121,231, 
249 

speaker 130,264 
SPEED statement 128,231 
SQR function 40,232,249 
square root 40,232 
statements 3,223,269 
see also names of statements 
step value 57ff 
stepwise refinement 189 
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STOP statement 17,73,216 
STR$ function 89,232 
string(s) 28,81,113,229,232,233, 
270, 275ff, 293, 295 
comparison 82 
constants 28,81,83 
conversion 89 
input 99 
null 28 

pointers 275-277 
storage 179 

variables 26,28,44,83,102, 
104,105,107 

STRING TOO LONG error 84, 
85,114, 251 

subroutine(s) 10,61 ff, 171,229, 
250, 269, 270, 276 
call 61 

execution 220 
nested 62 
subscripts 29,77,79 
substrings 86, 295 
subtraction 32,36 
syntax definitions 235ff 
syntax error 13,14,54,58,105, 
107,143ff, 166, 251 

T 

TAB function 113,120,121 ff, 126, 
181,232,249,254 
TAN function 41,233 
tangent 41,233 

tapecassette 13,14,110,156,158, 
165, 228, 230, 231,297ff 
termination 218,232 
text 142 253 

window 115,119ff, 129,136,143, 
221,253ff 

TEXT statement 119,136,143, 

233, 258 

TRACE command 180,181,226, 
233, 294 

trigonometric functions 40-41 
true 33ff 

truncation 28, 39,51,65,86,88, 
91,117,120ff, 283 
TYPE MISMATCH error 87,88, 
251 

u 

unconditional branch 50,220 
UNDEF'D FUNCTION error 251 
UNDEF'D STATEMENT error 12, 
50,51,64, 251,268 
I up-ARRQH] key 18,19,241 


user-defined function 44-45 
US R function 172,233 
utility strobe 131,261,264 

V 

UALfunction 83,86,90,102,105, 

107.233 

validation of data 187 
values, logical 33,54 
variable(s) 25ff, 51,97,98,177, 
216,268 
argument 44 
index 55,57,58,60 
integer 26 27,44,58 
name 26,293 

real 25, 27,44, 58,270,275ff 
string 26,28,44,102,105 
VLIN statement 140,234 
VTAB statement 119,120,124, 
181,234,256 

w 

WAIT statement 174,234,249 
wraparound 4,120,122 

X 

XDRAW statement 151,161 ff, 230, 

231.234 

XPLOT statement 246 

Y 
Z 

zero page 278 


Cast of Characters 

" (double quotation marks) 28,81, 
99,102,270 

# (number sign) 96,111,180,246 
t (dollar sign) 26,29,82,88,251, 

259 

1 (percent character) 26,28 
& (ampersand) 246 
( ) (parentheses) 37,250,276 

* (asterisk) 31,32 

+ (plus sign) 31,36,84,105 
i (comma) 98ff, 105,113ff 
- (minus sign) 31,36,105 
. (period) 105 
/ (slash) 31,296 
: (colon) 5,98ff, 105,106,177,192, 
246,267, 296, 301 

5 (semi-colon) 113ff, 122,267,269 
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< (less than) 34 

< = or = < (less than or equal to) 34 
= (equal sign) 30,34,44,129,137, 

145,163,246 

> (greater than) 34 

> = or = > (greater than or equal to) 34 

< > or > < (not equal to) 34 

? (question mark) 97,116,294 
1 (right bracket) 4,16,119,247 
\ (backslash) 4,18 
* (caret) 31 

80-Column Text Card 4,112ff, 119, 
124,125,127,222, 254,287ff 
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Tuck end flap 
inside back cover 
when using manual. 
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